/usr/share/doc/tklib/html/plotchart.html is in tklib 0.6-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378 2379 2380 2381 2382 2383 2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 2462 2463 2464 2465 2466 2467 2468 2469 2470 2471 2472 2473 2474 2475 2476 2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640 2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 2685 2686 2687 2688 2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 2733 2734 2735 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746 2747 2748 2749 2750 2751 2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 2765 2766 2767 2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778 2779 2780 2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811 2812 2813 2814 2815 2816 2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863 2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 2880 2881 2882 2883 2884 2885 2886 2887 2888 2889 2890 2891 2892 2893 2894 2895 2896 2897 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909 2910 2911 | <html><head>
<title>Plotchart - Plotchart</title>
<style type="text/css"><!--
HTML {
background: #FFFFFF;
color: black;
}
BODY {
background: #FFFFFF;
color: black;
}
DIV.doctools {
margin-left: 10%;
margin-right: 10%;
}
DIV.doctools H1,DIV.doctools H2 {
margin-left: -5%;
}
H1, H2, H3, H4 {
margin-top: 1em;
font-family: sans-serif;
font-size: large;
color: #005A9C;
background: transparent;
text-align: left;
}
H1.title {
text-align: center;
}
UL,OL {
margin-right: 0em;
margin-top: 3pt;
margin-bottom: 3pt;
}
UL LI {
list-style: disc;
}
OL LI {
list-style: decimal;
}
DT {
padding-top: 1ex;
}
UL.toc,UL.toc UL, UL.toc UL UL {
font: normal 12pt/14pt sans-serif;
list-style: none;
}
LI.section, LI.subsection {
list-style: none;
margin-left: 0em;
text-indent: 0em;
padding: 0em;
}
PRE {
display: block;
font-family: monospace;
white-space: pre;
margin: 0%;
padding-top: 0.5ex;
padding-bottom: 0.5ex;
padding-left: 1ex;
padding-right: 1ex;
width: 100%;
}
PRE.example {
color: black;
background: #f5dcb3;
border: 1px solid black;
}
UL.requirements LI, UL.syntax LI {
list-style: none;
margin-left: 0em;
text-indent: 0em;
padding: 0em;
}
DIV.synopsis {
color: black;
background: #80ffff;
border: 1px solid black;
font-family: serif;
margin-top: 1em;
margin-bottom: 1em;
}
UL.syntax {
margin-top: 1em;
border-top: 1px solid black;
}
UL.requirements {
margin-bottom: 1em;
border-bottom: 1px solid black;
}
--></style>
</head>
<! -- Generated from file 'plotchart.man' by tcllib/doctools with format 'html'
-->
<! -- Copyright © 2011 Arjen Markus <arjenmarkus@users.sourceforge.net>
-->
<! -- CVS: $Id$ Plotchart.n
-->
<body><div class="doctools">
<h1 class="title">Plotchart(3tk) 2.0.2 plotchart "Plotchart"</h1>
<div id="name" class="section"><h2><a name="name">Name</a></h2>
<p>Plotchart - Simple plotting and charting package</p>
</div>
<div id="toc" class="section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="toc">
<li class="section"><a href="#toc">Table Of Contents</a></li>
<li class="section"><a href="#synopsis">Synopsis</a></li>
<li class="section"><a href="#section1">Description</a></li>
<li class="section"><a href="#section2">PLOT CREATION COMMANDS</a></li>
<li class="section"><a href="#section3">PLOT METHODS</a></li>
<li class="section"><a href="#section4">COORDINATE TRANSFORMATIONS</a></li>
<li class="section"><a href="#section5">MISSING VALUES</a></li>
<li class="section"><a href="#section6">OTHER OUTPUT FORMATS</a></li>
<li class="section"><a href="#section7">SPECIAL EFFECTS</a></li>
<li class="section"><a href="#section8">ROOM FOR IMPROVEMENT</a></li>
<li class="section"><a href="#section9">RESIZING</a></li>
<li class="section"><a href="#section10">ZOOMING IN</a></li>
<li class="section"><a href="#section11">CONFIGURATION OPTIONS</a></li>
<li class="section"><a href="#section12">SCROLLING FOR TIMECHARTS AND GANTT CHARTS</a></li>
<li class="section"><a href="#section13">SPECIALISED PLOTS</a></li>
<li class="section"><a href="#section14">TABLE CHARTS</a></li>
<li class="section"><a href="#section15">CONTROL DISPLAYS</a></li>
<li class="section"><a href="#section16">ARRANGING MULTIPLE PLOTS IN A CANVAS</a></li>
<li class="section"><a href="#section17">INTERACTIVE USE</a></li>
<li class="section"><a href="#section18">NOTES ON TAGS</a></li>
<li class="section"><a href="#section19">TODO - SOME PRIVATE NOTES</a></li>
<li class="section"><a href="#keywords">Keywords</a></li>
<li class="section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="synopsis" class="section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="synopsis">
<ul class="requirements">
<li>package require <b class="pkgname">Tcl <span class="opt">?8.5?</span></b></li>
<li>package require <b class="pkgname">Tk <span class="opt">?8.5?</span></b></li>
<li>package require <b class="pkgname">Plotchart <span class="opt">?2.1.0?</span></b></li>
</ul>
<ul class="syntax">
<li><a href="#1"><b class="cmd">::Plotchart::createXYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i> <i class="arg">args</i></a></li>
<li><a href="#2"><b class="cmd">::Plotchart::createStripchart</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></li>
<li><a href="#3"><b class="cmd">::Plotchart::createTXPlot</b> <i class="arg">w</i> <i class="arg">timeaxis</i> <i class="arg">xaxis</i></a></li>
<li><a href="#4"><b class="cmd">::Plotchart::createXLogYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></li>
<li><a href="#5"><b class="cmd">::Plotchart::createLogXYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></li>
<li><a href="#6"><b class="cmd">::Plotchart::createLogXLogYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></li>
<li><a href="#7"><b class="cmd">::Plotchart::createPolarPlot</b> <i class="arg">w</i> <i class="arg">radius_data</i></a></li>
<li><a href="#8"><b class="cmd">::Plotchart::createWindrose</b> <i class="arg">w</i> <i class="arg">radius_data</i> <i class="arg">sectors</i></a></li>
<li><a href="#9"><b class="cmd">::Plotchart::createIsometricPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i> <i class="arg">stepsize</i></a></li>
<li><a href="#10"><b class="cmd">::Plotchart::createHistogram</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></li>
<li><a href="#11"><b class="cmd">::Plotchart::create3DPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i> <i class="arg">zaxis</i></a></li>
<li><a href="#12"><b class="cmd">::Plotchart::create3DRibbonPlot</b> <i class="arg">w</i> <i class="arg">yaxis</i> <i class="arg">zaxis</i></a></li>
<li><a href="#13"><b class="cmd">::Plotchart::createPiechart</b> <i class="arg">w</i></a></li>
<li><a href="#14"><b class="cmd">::Plotchart::createSpiralPie</b> <i class="arg">w</i></a></li>
<li><a href="#15"><b class="cmd">::Plotchart::createRadialchart</b> <i class="arg">w</i> <i class="arg">names</i> <i class="arg">scale</i> <i class="arg">style</i></a></li>
<li><a href="#16"><b class="cmd">::Plotchart::createBarchart</b> <i class="arg">w</i> <i class="arg">xlabels</i> <i class="arg">yaxis</i> <i class="arg">noseries</i></a></li>
<li><a href="#17"><b class="cmd">::Plotchart::createHorizontalBarchart</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">ylabel</i> <i class="arg">noseries</i></a></li>
<li><a href="#18"><b class="cmd">::Plotchart::create3DBarchart</b> <i class="arg">w</i> <i class="arg">yaxis</i> <i class="arg">nobars</i></a></li>
<li><a href="#19"><b class="cmd">::Plotchart::create3DRibbonChart</b> <i class="arg">w</i> <i class="arg">names</i> <i class="arg">yaxis</i> <i class="arg">zaxis</i></a></li>
<li><a href="#20"><b class="cmd">::Plotchart::createBoxplot</b> <i class="arg">w</i> <i class="arg">xdata</i> <i class="arg">ydata</i> <i class="arg">orientation</i></a></li>
<li><a href="#21"><b class="cmd">::Plotchart::createTimechart</b> <i class="arg">w</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">args</i></a></li>
<li><a href="#22"><b class="cmd">::Plotchart::createGanttchart</b> <i class="arg">w</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">args</i></a></li>
<li><a href="#23"><b class="cmd">::Plotchart::createRightAxis</b> <i class="arg">w_or_plot</i> <i class="arg">yaxis</i></a></li>
<li><a href="#24"><b class="cmd">::Plotchart::createTableChart</b> <i class="arg">w</i> <i class="arg">columns</i> <span class="opt">?widths?</span></a></li>
<li><a href="#25"><b class="cmd">$anyplot</b> title <i class="arg">text</i> <i class="arg">position</i></a></li>
<li><a href="#26"><b class="cmd">$anyplot</b> subtitle <i class="arg">text</i></a></li>
<li><a href="#27"><b class="cmd">$anyplot</b> canvas</a></li>
<li><a href="#28"><b class="cmd">$anyplot</b> saveplot <i class="arg">filename</i> <i class="arg">args</i></a></li>
<li><a href="#29"><b class="cmd">$anyplot</b> xtext <i class="arg">text</i></a></li>
<li><a href="#30"><b class="cmd">$anyplot</b> ytext <i class="arg">text</i></a></li>
<li><a href="#31"><b class="cmd">$anyplot</b> vtext <i class="arg">text</i></a></li>
<li><a href="#32"><b class="cmd">$anyplot</b> xsubtext <i class="arg">text</i></a></li>
<li><a href="#33"><b class="cmd">$anyplot</b> ysubtext <i class="arg">text</i></a></li>
<li><a href="#34"><b class="cmd">$anyplot</b> vsubtext <i class="arg">text</i></a></li>
<li><a href="#35"><b class="cmd">$anyplot</b> xconfig <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#36"><b class="cmd">$anyplot</b> yconfig <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#37"><b class="cmd">$anyplot</b> background <i class="arg">part</i> <i class="arg">colour_or_image</i> <i class="arg">dir</i> <span class="opt">?brightness?</span></a></li>
<li><a href="#38"><b class="cmd">$anyplot</b> xticklines <i class="arg">colour</i> <span class="opt">?dash?</span></a></li>
<li><a href="#39"><b class="cmd">$anyplot</b> yticklines <i class="arg">colour</i> <span class="opt">?dash?</span></a></li>
<li><a href="#40"><b class="cmd">$anyplot</b> legend <i class="arg">series</i> <i class="arg">text</i> <span class="opt">?spacing?</span></a></li>
<li><a href="#41"><b class="cmd">$anyplot</b> removefromlegend <i class="arg">series</i></a></li>
<li><a href="#42"><b class="cmd">$anyplot</b> legendconfig <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#43"><b class="cmd">$anyplot</b> balloon <i class="arg">x</i> <i class="arg">y</i> <i class="arg">text</i> <i class="arg">dir</i></a></li>
<li><a href="#44"><b class="cmd">$anyplot</b> balloonconfig <i class="arg">args</i></a></li>
<li><a href="#45"><b class="cmd">$anyplot</b> plaintext <i class="arg">x</i> <i class="arg">y</i> <i class="arg">text</i> <i class="arg">dir</i></a></li>
<li><a href="#46"><b class="cmd">$anyplot</b> plaintextconfig <i class="arg">args</i></a></li>
<li><a href="#47"><b class="cmd">$anyplot</b> object <i class="arg">itemtype</i> <i class="arg">series</i> <i class="arg">args</i></a></li>
<li><a href="#48"><b class="cmd">$anyplot</b> deletedata</a></li>
<li><a href="#49"><b class="cmd">$xyplot</b> plot <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></li>
<li><a href="#50"><b class="cmd">$xyplot</b> plotlist <i class="arg">series</i> <i class="arg">xlist</i> <i class="arg">ylist</i> <i class="arg">every</i></a></li>
<li><a href="#51"><b class="cmd">$histogram</b> plotcumulative <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></li>
<li><a href="#52"><b class="cmd">$xyplot</b> trend <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></li>
<li><a href="#53"><b class="cmd">$xyplot</b> rchart <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></li>
<li><a href="#54"><b class="cmd">$xyplot</b> interval <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ymin</i> <i class="arg">ymax</i> <span class="opt">?ycentr?</span></a></li>
<li><a href="#55"><b class="cmd">$xyplot</b> box-and-whiskers <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></li>
<li><a href="#56"><b class="cmd">$xyplot</b> vector <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">ucmp</i> <i class="arg">vcmp</i></a></li>
<li><a href="#57"><b class="cmd">$xyplot</b> vectorconfig <i class="arg">series</i> <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#58"><b class="cmd">$xyplot</b> dot <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">value</i></a></li>
<li><a href="#59"><b class="cmd">$xyplot</b> dotconfig <i class="arg">series</i> <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#60"><b class="cmd">$xyplot</b> contourlines <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">values</i> <span class="opt">?classes?</span></a></li>
<li><a href="#61"><b class="cmd">$xyplot</b> contourlinesfunctionvalues <i class="arg">xvec</i> <i class="arg">yvec</i> <i class="arg">valuesmat</i> <span class="opt">?classes?</span></a></li>
<li><a href="#62"><b class="cmd">$xyplot</b> contourfill <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">values</i> <span class="opt">?classes?</span></a></li>
<li><a href="#63"><b class="cmd">$xyplot</b> contourbox <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">values</i> <span class="opt">?classes?</span></a></li>
<li><a href="#64"><b class="cmd">$xyplot</b> colorMap <i class="arg">colours</i></a></li>
<li><a href="#65"><b class="cmd">$xyplot</b> legendisolines <i class="arg">values</i> <i class="arg">classes</i></a></li>
<li><a href="#66"><b class="cmd">$xyplot</b> legendshades <i class="arg">values</i> <i class="arg">classes</i></a></li>
<li><a href="#67"><b class="cmd">$xyplot</b> grid <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></li>
<li><a href="#68"><b class="cmd">$xyplot</b> xband <i class="arg">ymin</i> <i class="arg">ymax</i></a></li>
<li><a href="#69"><b class="cmd">$xyplot</b> yband <i class="arg">xmin</i> <i class="arg">xmax</i></a></li>
<li><a href="#70"><b class="cmd">$xyplot</b> labeldot <i class="arg">x</i> <i class="arg">y</i> <i class="arg">text</i> <i class="arg">orient</i></a></li>
<li><a href="#71"><b class="cmd">$polarplot</b> plot <i class="arg">series</i> <i class="arg">radius</i> <i class="arg">angle</i></a></li>
<li><a href="#72"><b class="cmd">$windrose</b> plot <i class="arg">data</i> <i class="arg">colour</i></a></li>
<li><a href="#73"><b class="cmd">$plot3d</b> plotfunc <i class="arg">function</i></a></li>
<li><a href="#74"><b class="cmd">$plot3d</b> plotfuncont <i class="arg">function</i> <i class="arg">contours</i></a></li>
<li><a href="#75"><b class="cmd">$plot3d</b> gridsize <i class="arg">nxcells</i> <i class="arg">nycells</i></a></li>
<li><a href="#76"><b class="cmd">$plot3d</b> plotdata <i class="arg">data</i></a></li>
<li><a href="#77"><b class="cmd">$plot3d</b> colours <i class="arg">fill</i> <i class="arg">border</i></a></li>
<li><a href="#78"><b class="cmd">$plot3d</b> ribbon <i class="arg">yzpairs</i></a></li>
<li><a href="#79"><b class="cmd">$plot3d</b> plot <i class="arg">yzpairs</i></a></li>
<li><a href="#80"><b class="cmd">$xyplot</b> dataconfig <i class="arg">series</i> <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#81"><b class="cmd">$pie</b> plot <i class="arg">data</i></a></li>
<li><a href="#82"><b class="cmd">$pie</b> colours <i class="arg">colour1</i> <i class="arg">colour2</i> ...</a></li>
<li><a href="#83"><b class="cmd">$pie</b> explode <i class="arg">segment</i></a></li>
<li><a href="#84"><b class="cmd">$radial</b> plot <i class="arg">data</i> <i class="arg">colour</i> <i class="arg">thickness</i></a></li>
<li><a href="#85"><b class="cmd">$pie</b> colours <i class="arg">colour1</i> <i class="arg">colour2</i> ...</a></li>
<li><a href="#86"><b class="cmd">$barchart</b> plot <i class="arg">series</i> <i class="arg">ydata</i> <i class="arg">colour</i> <span class="opt">?dir?</span> <span class="opt">?brightness?</span></a></li>
<li><a href="#87"><b class="cmd">$barchart</b> config <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#88"><b class="cmd">$barchart</b> plot <i class="arg">series</i> <i class="arg">xdata</i> <i class="arg">colour</i> <span class="opt">?dir?</span> <span class="opt">?brightness?</span></a></li>
<li><a href="#89"><b class="cmd">$barchart</b> config <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#90"><b class="cmd">$barchart</b> plot <i class="arg">label</i> <i class="arg">yvalue</i> <i class="arg">colour</i></a></li>
<li><a href="#91"><b class="cmd">$barchart</b> config <b class="option">-option</b> <i class="arg">value</i> ...</a></li>
<li><a href="#92"><b class="cmd">$ribbon</b> line <i class="arg">xypairs</i> <i class="arg">colour</i></a></li>
<li><a href="#93"><b class="cmd">$ribbon</b> area <i class="arg">xypairs</i> <i class="arg">colour</i></a></li>
<li><a href="#94"><b class="cmd">$boxplot</b> plot <i class="arg">series</i> <i class="arg">label</i> <i class="arg">values</i></a></li>
<li><a href="#95"><b class="cmd">$timechart</b> period <i class="arg">text</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">colour</i></a></li>
<li><a href="#96"><b class="cmd">$timechart</b> milestone <i class="arg">text</i> <i class="arg">time</i> <i class="arg">colour</i></a></li>
<li><a href="#97"><b class="cmd">$timechart</b> vertline <i class="arg">text</i> <i class="arg">time</i></a></li>
<li><a href="#98"><b class="cmd">$timechart</b> hscroll <i class="arg">scrollbar</i></a></li>
<li><a href="#99"><b class="cmd">$timechart</b> vscroll <i class="arg">scrollbar</i></a></li>
<li><a href="#100"><b class="cmd">$ganttchart</b> task <i class="arg">text</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">completed</i></a></li>
<li><a href="#101"><b class="cmd">$ganttchart</b> milestone <i class="arg">text</i> <i class="arg">time</i> <i class="arg">colour</i></a></li>
<li><a href="#102"><b class="cmd">$ganttchart</b> vertline <i class="arg">text</i> <i class="arg">time</i></a></li>
<li><a href="#103"><b class="cmd">$ganttchart</b> connect <i class="arg">from</i> <i class="arg">to</i></a></li>
<li><a href="#104"><b class="cmd">$ganttchart</b> summary <i class="arg">text</i> <i class="arg">args</i></a></li>
<li><a href="#105"><b class="cmd">$ganttchart</b> color <i class="arg">keyword</i> <i class="arg">newcolor</i></a></li>
<li><a href="#106"><b class="cmd">$ganttchart</b> font <i class="arg">keyword</i> <i class="arg">newfont</i></a></li>
<li><a href="#107"><b class="cmd">$ganttchart</b> hscroll <i class="arg">scrollbar</i></a></li>
<li><a href="#108"><b class="cmd">$ganttchart</b> vscroll <i class="arg">scrollbar</i></a></li>
<li><a href="#109"><b class="cmd">$isoplot</b> plot rectangle <i class="arg">x1</i> <i class="arg">y1</i> <i class="arg">x2</i> <i class="arg">y2</i> <i class="arg">colour</i></a></li>
<li><a href="#110"><b class="cmd">$isoplot</b> plot filled-rectangle <i class="arg">x1</i> <i class="arg">y1</i> <i class="arg">x2</i> <i class="arg">y2</i> <i class="arg">colour</i></a></li>
<li><a href="#111"><b class="cmd">$isoplot</b> plot circle <i class="arg">xc</i> <i class="arg">yc</i> <i class="arg">radius</i> <i class="arg">colour</i></a></li>
<li><a href="#112"><b class="cmd">$isoplot</b> plot filled-circle <i class="arg">xc</i> <i class="arg">yc</i> <i class="arg">radius</i> <i class="arg">colour</i></a></li>
<li><a href="#113"><b class="cmd">$table</b> row <i class="arg">items</i></a></li>
<li><a href="#114"><b class="cmd">$table</b> separator</a></li>
<li><a href="#115"><b class="cmd">$table</b> formatcommand <i class="arg">procname</i></a></li>
<li><a href="#116"><b class="cmd">$table</b> cellconfigure <i class="arg">args</i></a></li>
<li><a href="#117"><b class="cmd">::Plotchart::viewPort</b> <i class="arg">w</i> <i class="arg">pxmin</i> <i class="arg">pymin</i> <i class="arg">pxmax</i> <i class="arg">pymax</i></a></li>
<li><a href="#118"><b class="cmd">::Plotchart::worldCoordinates</b> <i class="arg">w</i> <i class="arg">xmin</i> <i class="arg">ymin</i> <i class="arg">xmax</i> <i class="arg">ymax</i></a></li>
<li><a href="#119"><b class="cmd">::Plotchart::world3DCoordinates</b> <i class="arg">w</i> <i class="arg">xmin</i> <i class="arg">ymin</i> <i class="arg">zmin</i> <i class="arg">xmax</i> <i class="arg">ymax</i> <i class="arg">zmax</i></a></li>
<li><a href="#120"><b class="cmd">::Plotchart::coordsToPixel</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i></a></li>
<li><a href="#121"><b class="cmd">::Plotchart::coords3DToPixel</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i> <i class="arg">z</i></a></li>
<li><a href="#122"><b class="cmd">::Plotchart::polarCoordinates</b> <i class="arg">w</i> <i class="arg">radmax</i></a></li>
<li><a href="#123"><b class="cmd">::Plotchart::polarToPixel</b> <i class="arg">w</i> <i class="arg">rad</i> <i class="arg">phi</i></a></li>
<li><a href="#124"><b class="cmd">::Plotchart::pixelToCoords</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i></a></li>
<li><a href="#125"><b class="cmd">::Plotchart::pixelToIndex</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i></a></li>
<li><a href="#126"><b class="cmd">::Plotchart::determineScale</b> <i class="arg">xmin</i> <i class="arg">xmax</i> <i class="arg">inverted</i></a></li>
<li><a href="#127"><b class="cmd">::Plotchart::determineScaleFromList</b> <i class="arg">values</i> <i class="arg">inverted</i></a></li>
<li><a href="#128"><b class="cmd">::Plotchart::plotconfig</b> <i class="arg">charttype</i> <i class="arg">component</i> <i class="arg">property</i> <i class="arg">value</i></a></li>
<li><a href="#129"><b class="cmd">::Plotchart::plotstyle</b> <i class="arg">subcmd</i> <i class="arg">style</i> <i class="arg">args</i></a></li>
<li><a href="#130"><b class="cmd">::Plotchart::createTargetDiagram</b> <i class="arg">w</i> <i class="arg">limits</i> <i class="arg">scale</i></a></li>
<li><a href="#131"><b class="cmd">$target</b> plot <i class="arg">series</i> <i class="arg">xvalues</i> <i class="arg">yvalues</i></a></li>
<li><a href="#132"><b class="cmd">::Plotchart::createPerformanceProfile</b> <i class="arg">w</i> <i class="arg">max</i></a></li>
<li><a href="#133"><b class="cmd">$performance</b> plot <i class="arg">series_and_data_pairs</i></a></li>
<li><a href="#134"><b class="cmd">::Plotchart::plotmethod</b> <i class="arg">charttype</i> <i class="arg">methodname</i> <i class="arg">plotproc</i></a></li>
<li><a href="#135"><b class="cmd">::Plotchart::plotpack</b> <i class="arg">w</i> <i class="arg">dir</i> <i class="arg">args</i></a></li>
<li><a href="#136"><b class="cmd">$anyplot</b> bindplot <i class="arg">event</i> <i class="arg">command</i> <i class="arg">args</i></a></li>
<li><a href="#137"><b class="cmd">$anyplot</b> bindlast <i class="arg">series</i> <i class="arg">event</i> <i class="arg">command</i></a></li>
</ul>
</div>
</div>
<div id="section1" class="section"><h2><a name="section1">Description</a></h2>
<p>Plotchart is a Tcl-only package that focuses on the easy creation of
xy-plots, barcharts and other common types of graphical presentations.
The emphasis is on ease of use, rather than flexibility. The procedures
that create a plot use the entire canvas window, making the layout
of the plot completely automatic.</p>
<p>This results in the creation of an xy-plot in, say, ten lines of code:</p>
<pre class="example">
package require Plotchart
canvas .c -background white -width 400 -height 200
pack .c -fill both
#
# Create the plot with its x- and y-axes
#
set s [::Plotchart::createXYPlot .c {0.0 100.0 10.0} {0.0 100.0 20.0}]
foreach {x y} {0.0 32.0 10.0 50.0 25.0 60.0 78.0 11.0 } {
$s plot series1 $x $y
}
$s title "Data series"
</pre>
<p>A drawback of the package might be that it does not do any data
management. So if the canvas that holds the plot is to be resized, the
whole plot must be redrawn.
The advantage, though, is that it offers a number of plot and chart
types:</p>
<ul class="itemized">
<li><p>XY-plots like the one shown above with any number of data series.</p></li>
<li><p>Stripcharts, a kind of XY-plots where the horizontal axis is adjusted
automatically. The result is a kind of sliding window on the data
series.</p></li>
<li><p>Polar plots, where the coordinates are polar instead of cartesian.</p></li>
<li><p>Histograms, for plotting statistical information.</p></li>
<li><p>Isometric plots, where the scale of the coordinates in the two
directions is always the same, i.e. a circle in world coordinates
appears as a circle on the screen.</p>
<p>You can zoom in and out, as well as pan with these plots (<em>Note:</em>
this works best if no axes are drawn, the zooming and panning routines
do not distinguish the axes), using the mouse buttons with the control
key and the arrow keys with the control key.</p></li>
<li><p>Piecharts, with automatic scaling to indicate the proportions.</p></li>
<li><p>Barcharts, with either vertical or horizontal bars, stacked bars or
bars side by side.</p></li>
<li><p>Timecharts, where bars indicate a time period and milestones or other
important moments in time are represented by triangles.</p></li>
<li><p>3D plots (both for displaying surfaces and 3D bars)</p></li>
</ul>
<p>With version 1.5 a new command has been introduced: plotconfig, which
can be used to configure the plot options for particular types of plots
and charts (cf. <span class="sectref"><a href="#section11">CONFIGURATION OPTIONS</a></span>)
With version 1.8.3 several new features were introduced, which allow more interactivity
(cf. <span class="sectref"><a href="#section17">INTERACTIVE USE</a></span>)</p>
</div>
<div id="section2" class="section"><h2><a name="section2">PLOT CREATION COMMANDS</a></h2>
<p>You create the plot or chart with one single command and then fill the
plot with data:</p>
<dl class="definitions">
<dt><a name="1"><b class="cmd">::Plotchart::createXYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i> <i class="arg">args</i></a></dt>
<dd><p>Create a new xy-plot (configuration type: xyplot).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the x-axis, in this order.
For an inverted axis, where the maximum appears on the left-hand side,
use: maximum, minimum and a <em>negative</em> stepsize.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.
For an inverted axis, where the maximum appears at the bottom,
use: maximum, minimum and a <em>negative</em> stepsize.</p></dd>
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>Zero or more options that influence the appearance of the plot:</p>
<ul class="itemized">
<li><p><em>-xlabels {labels}:</em> Custom labels for the x-axis. If the labels
are numeric, they are positioned according to the given scale,
otherwise they are positioned with equal distance, based on the number
of labels. Note: this only works if the stepsize of the xaxis argument is
the empty string.</p></li>
<li><p><em>-ylabels {labels}:</em> Similarly, custom labels for the y-axis.</p></li>
<li><p><em>-box {measures}:</em> See <span class="sectref"><a href="#section16">ARRANGING MULTIPLE PLOTS IN A CANVAS</a></span></p></li>
<li><p><em>-axesbox {measures}:</em> See <span class="sectref"><a href="#section16">ARRANGING MULTIPLE PLOTS IN A CANVAS</a></span></p></li>
</ul></dd>
</dl></dd>
<dt><a name="2"><b class="cmd">::Plotchart::createStripchart</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></dt>
<dd><p>Create a new strip chart (configuration type: stripchart). The
only difference to a regular XY plot is
that the x-axis will be automatically adjusted when the x-coordinate
of a new point exceeds the maximum.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the x-axis, in this order.
Note that an inverted x-axis is <em>not</em> supported for this type of plot.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.
For an inverted axis, where the maximum appears at the bottom,
use: maximum, minimum and a <em>negative</em> stepsize.</p></dd>
</dl></dd>
<dt><a name="3"><b class="cmd">::Plotchart::createTXPlot</b> <i class="arg">w</i> <i class="arg">timeaxis</i> <i class="arg">xaxis</i></a></dt>
<dd><p>Create a new time-x-plot (configuration type: txplot). The horizontal axis represents the date/time
of the data and the vertical axis the values themselves.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">timeaxis</i> (in)</dt>
<dd><p>A 3-element list containing the minimum and maximum date/time to be
shown and the stepsize (<em>in days</em>) for the time-axis, in this order.
Note that an inverted time-axis is <em>not</em> supported.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the
vertical axis, in this order.
For an inverted axis, where the maximum appears at the bottom,
use: maximum, minimum and a <em>negative</em> stepsize.</p></dd>
</dl></dd>
<dt><a name="4"><b class="cmd">::Plotchart::createXLogYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></dt>
<dd><p>Create a new xy-plot where the y-axis has a logarithmic scale (configuration type: xlogyplot).</p>
<p>The data should be given as for a linear scale, as the logarithmic transformation
is taken of internally.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the x-axis, in this order.
For an inverted axis, where the maximum appears on the left-hand side,
use: maximum, minimum and a <em>negative</em> stepsize.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 2-element list containing minimum and maximum for the y-axis, in this order.
Note that an inverted logarithmic axis is <em>not</em> supported.</p></dd>
</dl></dd>
<dt><a name="5"><b class="cmd">::Plotchart::createLogXYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></dt>
<dd><p>Create a new xy-plot where the x-axis has a logarithmic scale (configuration type: logxyplot).</p>
<p>The data should be given as for a linear scale, as the logarithmic transformation
is taken of internally.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 2-element list containing minimum and maximum for the x-axis, in this order.
Note that an inverted logarithmic axis is <em>not</em> supported.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.
For an inverted axis, where the maximum appears on the left-hand side,
use: maximum, minimum and a <em>negative</em> stepsize.</p></dd>
</dl></dd>
<dt><a name="6"><b class="cmd">::Plotchart::createLogXLogYPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></dt>
<dd><p>Create a new xy-plot where both the x-axis and the y-axis have a logarithmic scale
(configuration type: logxlogyplot).</p>
<p>The data should be given as for a linear scale, as the logarithmic transformation
is taken of internally.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 2-element list containing minimum and maximum for the x-axis, in this order.
Note that an inverted logarithmic axis is <em>not</em> supported.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 2-element list containing minimum and maximum for the y-axis, in this order.
Note that an inverted logarithmic axis is <em>not</em> supported.</p></dd>
</dl></dd>
<dt><a name="7"><b class="cmd">::Plotchart::createPolarPlot</b> <i class="arg">w</i> <i class="arg">radius_data</i></a></dt>
<dd><p>Create a new polar plot (configuration type: polarplot).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">radius_data</i> (in)</dt>
<dd><p>A 2-element list containing maximum radius and stepsize for the radial
axis, in this order.</p></dd>
</dl></dd>
<dt><a name="8"><b class="cmd">::Plotchart::createWindrose</b> <i class="arg">w</i> <i class="arg">radius_data</i> <i class="arg">sectors</i></a></dt>
<dd><p>Create a new windrose diagram. The diagram will consist of concentric
circles as defined by the <i class="term">radius_data</i> argument and a number of
sectors (given by the <i class="term">sectors</i> argument). The sectors are drawn in
the "nautical" convention, that is: the first is located at the positive
y-axis, the second is to the right and so on in a clockwise direction.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the diagram</p></dd>
<dt>list <i class="arg">radius_data</i> (in)</dt>
<dd><p>A 2-element list, the first element is the maximum radius, the second is
the step to be used for the circles.</p></dd>
<dt>int <i class="arg">sectors</i></dt>
<dd><p>Number of sectors to use (defaults to 16).</p></dd>
</dl></dd>
<dt><a name="9"><b class="cmd">::Plotchart::createIsometricPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i> <i class="arg">stepsize</i></a></dt>
<dd><p>Create a new isometric plot, where the vertical and the horizontal
coordinates are scaled so that a circle will truly appear as a circle (configuration type: isometric).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 2-element list containing minimum, and maximum for the x-axis, in this order.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 2-element list containing minimum, and maximum for the y-axis, in this order.</p></dd>
<dt>float|<b class="const">noaxes</b> <i class="arg">stepsize</i> (in)</dt>
<dd><p>Either the stepsize used by both axes or the keyword <b class="const">noaxes</b> to
signal the plot that it should use the full area of the widget, to not
draw any of the axes.</p></dd>
</dl></dd>
<dt><a name="10"><b class="cmd">::Plotchart::createHistogram</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i></a></dt>
<dd><p>Create a new histogram (configuration type: histogram).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the x-axis, in this order.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.</p></dd>
</dl></dd>
<dt><a name="11"><b class="cmd">::Plotchart::create3DPlot</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">yaxis</i> <i class="arg">zaxis</i></a></dt>
<dd><p>Create a new 3D plot.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the x-axis, in this order.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.</p></dd>
<dt>list <i class="arg">zaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the z-axis, in this order.</p></dd>
</dl></dd>
<dt><a name="12"><b class="cmd">::Plotchart::create3DRibbonPlot</b> <i class="arg">w</i> <i class="arg">yaxis</i> <i class="arg">zaxis</i></a></dt>
<dd><p>Create a new 3D ribbon plot. It is a simplification of the full 3D plot and allows for
the drawing of a ribbon only (the x-axis is dropped).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.</p></dd>
<dt>list <i class="arg">zaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the z-axis, in this order.</p></dd>
</dl></dd>
<dt><a name="13"><b class="cmd">::Plotchart::createPiechart</b> <i class="arg">w</i></a></dt>
<dd><p>Create a new piechart (configuration type: piechart).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
</dl></dd>
<dt><a name="14"><b class="cmd">::Plotchart::createSpiralPie</b> <i class="arg">w</i></a></dt>
<dd><p>Create a new "spiral pie" (configuration type: spiralpie), a variation on the ordinary
piechart. The value is used to scale the radius, rather than the angle. By default the
data are sorted.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
</dl></dd>
<dt><a name="15"><b class="cmd">::Plotchart::createRadialchart</b> <i class="arg">w</i> <i class="arg">names</i> <i class="arg">scale</i> <i class="arg">style</i></a></dt>
<dd><p>Create a new radial chart (the data are drawn as a line connecting the
spokes of the diagram) (configuration type: radialchart).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">names</i> (in)</dt>
<dd><p>Names for the spokes.</p></dd>
<dt>float <i class="arg">scale</i> (in)</dt>
<dd><p>Scale value to determine the position of the data along the spokes.</p></dd>
<dt>string <i class="arg">style</i> (in)</dt>
<dd><p>Style of the chart (optional). One of:</p>
<ul class="itemized">
<li><p><em>lines</em> - the default: draw the data as independent polylines.</p></li>
<li><p><em>cumulative</em> - draw the data as polylines where the data are
accumulated.</p></li>
<li><p><em>filled</em> - draw the data as filled polygons where the data are
accumulated</p></li>
</ul></dd>
</dl></dd>
<dt><a name="16"><b class="cmd">::Plotchart::createBarchart</b> <i class="arg">w</i> <i class="arg">xlabels</i> <i class="arg">yaxis</i> <i class="arg">noseries</i></a></dt>
<dd><p>Create a new barchart with vertical bars (configuration type: vertbars). The horizontal axis will
display the labels contained in the argument <i class="arg">xlabels</i>. The number
of series given by <i class="arg">noseries</i> determines both the width of the
bars, and the way the series will be drawn.</p>
<p>If the keyword <b class="const">stacked</b> was specified the series will be drawn
stacked on top of each other. Otherwise each series that is drawn will
be drawn shifted to the right.</p>
<p>The number of series determines the width of the bars, so that there is
space of that number of bars. If you use a floating-point number, like
2.2, instead of an integer, like 2, a small gap between the sets of bars
will be drawn - the width depends on the fractional part.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xlabels</i> (in)</dt>
<dd><p>List of labels for the x-axis. Its length also determines the number of
bars that will be plotted per series.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.</p></dd>
<dt>int|<b class="const">stacked</b> <i class="arg">noseries</i> (in)</dt>
<dd><p>The number of data series that will be plotted. This has to be an
integer number greater than zero (if <b class="const">stacked</b> is not used).</p></dd>
</dl></dd>
<dt><a name="17"><b class="cmd">::Plotchart::createHorizontalBarchart</b> <i class="arg">w</i> <i class="arg">xaxis</i> <i class="arg">ylabel</i> <i class="arg">noseries</i></a></dt>
<dd><p>Create a new barchart with horizontal bars (configuration type: horizbars). The vertical axis will
display the labels contained in the argument <i class="arg">ylabels</i>. The number
of series given by <i class="arg">noseries</i> determines both the width of the
bars, and the way the series will be drawn.</p>
<p>If the keyword <b class="const">stacked</b> was specified the series will be drawn
stacked from left to right. Otherwise each series that is drawn will
be drawn shifted upward.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the x-axis, in this order.</p></dd>
<dt>list <i class="arg">ylabels</i> (in)</dt>
<dd><p>List of labels for the y-axis. Its length also determines the number of
bars that will be plotted per series.</p></dd>
<dt>int|<b class="const">stacked</b> <i class="arg">noseries</i> (in)</dt>
<dd><p>The number of data series that will be plotted. This has to be an
integer number greater than zero (if <b class="const">stacked</b> is not used).</p></dd>
</dl></dd>
<dt><a name="18"><b class="cmd">::Plotchart::create3DBarchart</b> <i class="arg">w</i> <i class="arg">yaxis</i> <i class="arg">nobars</i></a></dt>
<dd><p>Create a new barchart with 3D vertical bars (configuration type: 3dbars). The horizontal axis will
display the labels per bar. The number of bars given by <i class="arg">nobars</i>
determines the position and the width of the bars. The colours can be
varied per bar. (This type of chart was inspired by the Wiki page on 3D
bars by Richard Suchenwirth.)</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.</p></dd>
<dt>int <i class="arg">nobars</i> (in)</dt>
<dd><p>The number of bars that will be plotted.</p></dd>
</dl></dd>
<dt><a name="19"><b class="cmd">::Plotchart::create3DRibbonChart</b> <i class="arg">w</i> <i class="arg">names</i> <i class="arg">yaxis</i> <i class="arg">zaxis</i></a></dt>
<dd><p>Create a new "ribbon chart" (configuration type: 3dribbon). This is
a chart where the data series are
represented as ribbons in a three-dimensional axis system. Along the
x-axis (which is "into" the screen) the names are plotted, each
representing a single series. The first plot command draws the furthest
series, the second draws the series in front of that and so on.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Names of the series, plotted as labels along the x-axis</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis
(drawn horizontally!), in this order.</p></dd>
<dt>list <i class="arg">zaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the z-axis
(drawn vertically), in this order.</p></dd>
<dt>int <i class="arg">nobars</i> (in)</dt>
<dd><p>The number of bars that will be plotted.</p></dd>
</dl></dd>
<dt><a name="20"><b class="cmd">::Plotchart::createBoxplot</b> <i class="arg">w</i> <i class="arg">xdata</i> <i class="arg">ydata</i> <i class="arg">orientation</i></a></dt>
<dd><p>Create a new boxplot with horizontal or vertical boxes (box-and-whiskers) (configuration type: boxplot). Depending
on the orientation the x- or y-axis is drawn with labels. The boxes are drawn based on the raw data
(see the plot subcommand for this type of plot).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">xdata</i> (in)</dt>
<dd><p>This is either a 3-element list containing minimum, maximum and stepsize for the x-axis, in this order
(when orientation is horizontal), or a list of labels for the x-axis (when orientation is vertical). The length
of the label list also determines the number of boxes that can be plotted. The labels are also used in the plot
subcommand.</p></dd>
<dt>list <i class="arg">ydata</i> (in)</dt>
<dd><p>This is either a 3-element list containing minimum, maximum and stepsize for the y-axis, in this order
(when orientation is vertical), or a list of labels for the y-axis (when orientation is horizontal). The length
of the label list also determines the number of boxes that can be plotted. The labels are also used in the plot
subcommand.</p></dd>
<dt>string <i class="arg">orientation</i> (in)</dt>
<dd><p>If given, "horizontal" or "vertical" determines the orientation of the boxes. This optional value (default: horizontal)
also determines the interpretation of the xdata and ydata arguments.</p></dd>
</dl></dd>
<dt><a name="21"><b class="cmd">::Plotchart::createTimechart</b> <i class="arg">w</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">args</i></a></dt>
<dd><p>Create a new timechart (configuration type: timechart).
The time axis (= x-axis) goes from <i class="arg">time_begin</i> to <i class="arg">time_end</i>,
and the vertical spacing is determined by the number of items to plot.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>string <i class="arg">time_begin</i> (in)</dt>
<dd><p>The start time given in a form that is recognised by the <b class="cmd">clock scan</b>
command (e.g. "1 january 2004").</p></dd>
<dt>string <i class="arg">time_end</i> (in)</dt>
<dd><p>The end time given in a form that is recognised by the <b class="cmd">clock scan</b>
command (e.g. "1 january 2004").</p></dd>
<dt>arguments <i class="arg">args</i> (in)</dt>
<dd><p>The remaining arguments can be:</p>
<ul class="itemized">
<li><p>The expected/maximum number of items. This determines the vertical
spacing. (If given, it must be the first argument after "time_end"</p></li>
<li><p>The keyword -barheight and the number of pixels per bar. This is an
alternative method to determine the vertical spacing.</p></li>
<li><p>The keyword -ylabelwidth and the number of pixels to reserve for the
labels at the y-axis.</p></li>
</ul></dd>
</dl></dd>
<dt><a name="22"><b class="cmd">::Plotchart::createGanttchart</b> <i class="arg">w</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">args</i></a></dt>
<dd><p>Create a new Gantt chart (configuration type: ganttchart).
The time axis (= x-axis) goes from <i class="arg">time_begin</i> to <i class="arg">time_end</i>,
and the vertical spacing is determined by the number of items to plot.
Via the specific commands you can then add tasks and connections between
the tasks.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>string <i class="arg">time_begin</i> (in)</dt>
<dd><p>The start time given in a form that is recognised by the <b class="cmd">clock scan</b>
command (e.g. "1 january 2004").</p></dd>
<dt>string <i class="arg">time_end</i> (in)</dt>
<dd><p>The end time given in a form that is recognised by the <b class="cmd">clock scan</b>
command (e.g. "1 january 2004").</p></dd>
<dt>arguments <i class="arg">args</i> (in)</dt>
<dd><p>The remaining arguments can be:</p>
<ul class="itemized">
<li><p>The expected/maximum number of items. This determines the vertical
spacing. (If given this way, it must be the first argument after "time_end")</p></li>
<li><p>The expected/maximum width of the descriptive text (roughly in characters,
for the actual space reserved for the text, it is assumed that a
character is about ten pixels wide). Defaults to 20. (If given this way,
it must be the second argument after "time_end").</p></li>
<li><p>The keyword -barheight and the number of pixels per bar. This is an
alternative method to determine the vertical spacing.</p></li>
<li><p>The keyword -ylabelwidth and the number of pixels to reserve for the
labels at the y-axis.</p></li>
</ul></dd>
</dl></dd>
<dt><a name="23"><b class="cmd">::Plotchart::createRightAxis</b> <i class="arg">w_or_plot</i> <i class="arg">yaxis</i></a></dt>
<dd><p>Create a plot command that will use a right axis instead of the left
axis (configuration type: inherited from the existing plot). The canvas widget
must already contain an ordinary plot, as the
horizontal axis and other properties are reused. Preferably use the
plot command, as with multiple plots in a canvas (also when redefining an existing
plot!), the wrong geometry might be used.</p>
<p>To plot data using the
right axis, use this new command, to plot data using the <em>left</em>
axis, use the original plot command.</p>
<dl class="arguments">
<dt>widget <i class="arg">w_or_plot</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot or preferably the
plot command for the plot with the left axis.</p></dd>
<dt>list <i class="arg">yaxis</i> (in)</dt>
<dd><p>A 3-element list containing minimum, maximum and stepsize for the y-axis, in this order.</p></dd>
</dl></dd>
<dt><a name="24"><b class="cmd">::Plotchart::createTableChart</b> <i class="arg">w</i> <i class="arg">columns</i> <span class="opt">?widths?</span></a></dt>
<dd><p>Create a command to draw a table. You can use a variety of commands to
draw the actual rows of the table, but the number of columns is fixed.
(See <span class="sectref"><a href="#section14">TABLE CHARTS</a></span> for an example)</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the canvas widget to hold the table.</p></dd>
<dt>list <i class="arg">columns</i> (in)</dt>
<dd><p>The headers of the columns in the table. The number of elements
determines the number of columns.</p></dd>
<dt>list <i class="arg">widths</i> (in)</dt>
<dd><p>If given, either a single value, the width in pixels for all columns or
for each column the width of that column. If not given, the table is
spread out over the width of the canvas (minus the margins).</p></dd>
</dl></dd>
</dl>
</div>
<div id="section3" class="section"><h2><a name="section3">PLOT METHODS</a></h2>
<p>Each of the creation commands explained in the last section returns
the name of a new object command that can be used to manipulate the
plot or chart. The subcommands available to a chart command depend on
the type of the chart.</p>
<p>General subcommands for all types of charts. \$anyplot is the command
returned by the creation command:</p>
<dl class="definitions">
<dt><a name="25"><b class="cmd">$anyplot</b> title <i class="arg">text</i> <i class="arg">position</i></a></dt>
<dd><p>Specify the title of the whole chart.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text of the title to be drawn.</p></dd>
<dt>string <i class="arg">position</i> (in)</dt>
<dd><p>The position of the title. The default position is "center", but you can
alternatively use "left" or "right". You can use multiple titles with
different positions.</p></dd>
</dl></dd>
<dt><a name="26"><b class="cmd">$anyplot</b> subtitle <i class="arg">text</i></a></dt>
<dd><p>Specify the subtitle of the whole chart.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text of the subtitle to be drawn.</p></dd>
</dl></dd>
<dt><a name="27"><b class="cmd">$anyplot</b> canvas</a></dt>
<dd><p>Return the name of the canvas (or the alias if you use more than one plot within a
canvas). Use this value for the coordinate transformations.</p></dd>
<dt><a name="28"><b class="cmd">$anyplot</b> saveplot <i class="arg">filename</i> <i class="arg">args</i></a></dt>
<dd><p>Draws the plot into a file, using PostScript.</p>
<dl class="arguments">
<dt>string <i class="arg">filename</i> (in)</dt>
<dd><p>Contain the path name of the file to write the plot to.</p></dd>
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>If the standard PostScript output is used, the option -plotregion can be specifed
to save the whole plot (value: bbox) regardless of what is visible in the window.
The default (value: window) is to only plot the visible part of the plot.</p>
<p>Optionally you can specify the option -format "some picture format" to
store the plot in a different file than a PostScript file. This,
however, relies on the Img package to do the actual job.</p>
<p><em>Note:</em>
Because the window holding the plot must be fully visible before Img can
successfully grab it, it is raised first.
On some systems, for instance Linux with KDE, raising
a window is not done automatically, but instead you need to click on the
window in the task bar. Similar things happen on Windows XP.</p>
<p>There seems to be something wrong under some circumstances, so instead
of waiting for the visibility of the window, the procedure simply waits
two seconds. It is not ideal, but it seems to work better.</p></dd>
</dl></dd>
<dt><a name="29"><b class="cmd">$anyplot</b> xtext <i class="arg">text</i></a></dt>
<dd><p>Specify the title of the (horizontal) x-axis, for those plots that have
a straight x-axis.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text of the x-axis label to be drawn.</p></dd>
</dl></dd>
<dt><a name="30"><b class="cmd">$anyplot</b> ytext <i class="arg">text</i></a></dt>
<dd><p>Specify the title of the (horizontal) y-axis, for those plots that have
a straight y-axis.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text of the y-axis label to be drawn.</p></dd>
</dl></dd>
<dt><a name="31"><b class="cmd">$anyplot</b> vtext <i class="arg">text</i></a></dt>
<dd><p>Draw a <em>vertical</em> label to the y-axis. Note: this requires Tk 8.6
or later, for older versions it does nothing.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>Text to drawn to the y-axis</p></dd>
</dl></dd>
<dt><a name="32"><b class="cmd">$anyplot</b> xsubtext <i class="arg">text</i></a></dt>
<dd><p>Specify the subtext of the (horizontal) x-axis, for those plots that have
a straight x-axis. This text is drawn below the primary text.</p>
<p>Since this involves positioning the primary text and setting margins, you need to
set the option "usesubtext" for the bottom axis via the plotstyle command. The relevant
options are: usesubtext, subtextcolor and subtextfont.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The secondary text of the x-axis label to be drawn.</p></dd>
</dl></dd>
<dt><a name="33"><b class="cmd">$anyplot</b> ysubtext <i class="arg">text</i></a></dt>
<dd><p>Specify the subtext of the (vertical) y-axis, for those plots that have
a straight y-axis. This text is drawn below the primary text, for both
axes on the left and the right.</p>
<p>Since this involves positioning the primary text and setting margins, you need to
set the option "usesubtext" for the left or right axis via the plotstyle command. The relevant
options are: usesubtext, subtextcolor and subtextfont.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The secondary text of the y-axis label to be drawn.</p></dd>
</dl></dd>
<dt><a name="34"><b class="cmd">$anyplot</b> vsubtext <i class="arg">text</i></a></dt>
<dd><p>Specify the subtext of the (vertical) y-axis, for those plots that have
a straight y-axis. This text is drawn to the <em>right</em> of the primary text, for both
axes on the left and the right.</p>
<p>Since this involves positioning the primary text and setting margins, you need to
set the option "usesubtext" for the left or right axis via the plotstyle command. The relevant
options are: usevsubtext, vsubtextcolor and vsubtextfont. (Note the "v" to distinguish this
option from the text at the top of a vertical axis that is drawn via <i class="term">$anyplot ytext</i> or
<i class="term">$anyplot ysubtext</i>.)</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The secondary (vertical) text of the y-axis label to be drawn.</p></dd>
</dl></dd>
<dt><a name="35"><b class="cmd">$anyplot</b> xconfig <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>Set one or more configuration parameters for the x-axis.
The following options are supported:</p>
<dl class="options">
<dt><b class="option">format</b> fmt</dt>
<dd><p>The format for the numbers along the axis.</p></dd>
<dt><b class="option">ticklength</b> length</dt>
<dd><p>The length of the tickmarks (in pixels).</p></dd>
<dt><b class="option">ticklines</b> boolean</dt>
<dd><p>Whether to draw ticklines (<b class="const">true</b>) or not (<b class="const">false</b>).</p></dd>
<dt><b class="option">scale</b> scale_data</dt>
<dd><p>New scale data for the axis, i.e. a 3-element list containing minimum,
maximum and stepsize for the axis, in this order.</p>
<p><em>Beware:</em> Setting this option will clear all data from the plot.</p></dd>
</dl></dd>
<dt><a name="36"><b class="cmd">$anyplot</b> yconfig <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>Set one or more configuration parameters for the y-axis. This method
accepts the same options and values as the method <b class="method">xconfig</b>.</p></dd>
<dt><a name="37"><b class="cmd">$anyplot</b> background <i class="arg">part</i> <i class="arg">colour_or_image</i> <i class="arg">dir</i> <span class="opt">?brightness?</span></a></dt>
<dd><p>Set the background of a part of the plot</p>
<dl class="arguments">
<dt>string <i class="arg">part</i></dt>
<dd><p>Which part of the plot: "axes" for the axes area and "plot" for the
inner part. The interpretation depends on the type of plot. Two further
possibilities are:</p>
<ul class="itemized">
<li><p><em>image</em>, in which case a predefined image is loaded
into the background of the plot.</p></li>
<li><p><em>gradient</em>, in which case the background is coloured in different
shades of the given colour. The "dir" argument specifies the direction
in which the colour gets whiter.</p></li>
</ul></dd>
<dt>string <i class="arg">colour_or_image</i></dt>
<dd><p>Colour for that part or the name of the image if "part" is "image"</p></dd>
<dt>string <i class="arg">dir</i></dt>
<dd><p>The direction of the gradient. One of: top-down, bottom-up, left-right
or right-left.</p></dd>
<dt>string <i class="arg">brightness</i></dt>
<dd><p>Indicates whether the colour should become brighter (bright) or darker (dark). Defaults to bright</p></dd>
</dl></dd>
<dt><a name="38"><b class="cmd">$anyplot</b> xticklines <i class="arg">colour</i> <span class="opt">?dash?</span></a></dt>
<dd><p>Draw vertical ticklines at each tick location</p>
<dl class="arguments">
<dt>string <i class="arg">colour</i></dt>
<dd><p>Colour of the lines. Specifying an empty colour ("") removes them again.
Defaults to "black"</p></dd>
<dt>string <i class="arg">dash</i></dt>
<dd><p>Optional argument to specify the dash pattern for the lines. Defaults to "lines"
Possible values: lines, dots1, dots2, dots3, dots4, dots5.
The actual effect depends on the platform.</p></dd>
</dl></dd>
<dt><a name="39"><b class="cmd">$anyplot</b> yticklines <i class="arg">colour</i> <span class="opt">?dash?</span></a></dt>
<dd><p>Draw horizontal ticklines at each tick location</p>
<dl class="arguments">
<dt>string <i class="arg">colour</i></dt>
<dd><p>Colour of the lines. Specifying an empty colour ("") removes them again
Defaults to "black"</p></dd>
<dt>string <i class="arg">dash</i></dt>
<dd><p>Optional argument to specify the dash pattern for the lines. Defaults to "lines"
Possible values: lines, dots1, dots2, dots3, dots4, dots5.
The actual effect depends on the platform.</p></dd>
</dl></dd>
<dt><a name="40"><b class="cmd">$anyplot</b> legend <i class="arg">series</i> <i class="arg">text</i> <span class="opt">?spacing?</span></a></dt>
<dd><p>Add an entry to the legend. The series determines which graphical
symbol is to be used. (As a side effect the legend is actually drawn.)</p>
<dl class="arguments">
<dt>string <i class="arg">series</i></dt>
<dd><p>Name of the data series. This determines the colour of the line and the
symbol (if any) that will be drawn.</p></dd>
<dt>string <i class="arg">text</i></dt>
<dd><p>Text to be drawn next to the line/symbol.</p></dd>
<dt>integer <i class="arg">spacing</i></dt>
<dd><p>Optional argument to specify the vertical spacing between the entries (in pixels).
(Note that this spacing will be reused later.)</p></dd>
</dl></dd>
<dt><a name="41"><b class="cmd">$anyplot</b> removefromlegend <i class="arg">series</i></a></dt>
<dd><p>Remove an entry for a series from the legend and redraw it.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i></dt>
<dd><p>Name of the data series to be removed.</p></dd>
</dl></dd>
<dt><a name="42"><b class="cmd">$anyplot</b> legendconfig <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>Set one or more options for the legend. The legend is drawn as a
rectangle with text and graphics inside.</p>
<dl class="options">
<dt><b class="option">background</b> colour</dt>
<dd><p>Set the colour of the background (the default colour is white).
Set to the empty string for a transparant legend.</p></dd>
<dt><b class="option">border</b> colour</dt>
<dd><p>Set the colour of the border (the default colour is black). Set to the
empty string if you do not want a border.</p></dd>
<dt><b class="option">canvas</b> c</dt>
<dd><p>Draw the legend in a different canvas widget. This gives you the freedom
to position the legend outside the actual plot.</p></dd>
<dt><b class="option">font</b> font</dt>
<dd><p>Set the font used to draw the text next to the symbol.</p></dd>
<dt><b class="option">legendtype</b></dt>
<dd><p>Override the type of the legend, that is pre-defined for the current type of
plot. May be one of: rectangle or line.</p></dd>
<dt><b class="option">position</b> corner</dt>
<dd><p>Set the position of the legend. May be one of: top-left, top-right,
bottom-left or bottom-right. (Default value is top-right.)</p></dd>
</dl></dd>
<dt><a name="43"><b class="cmd">$anyplot</b> balloon <i class="arg">x</i> <i class="arg">y</i> <i class="arg">text</i> <i class="arg">dir</i></a></dt>
<dd><p>Add balloon text to the plot (except for 3D plots). The arrow will point
to the given x- and y-coordinates. For xy-graphs and such, the
coordinates are directly related to the axes; for vertical barcharts the
x-coordinate is measured as the number of bars minus 1 and similar for
horizontal barcharts.</p>
<dl class="arguments">
<dt>float <i class="arg">x</i></dt>
<dd><p>X-coordinate of the point that the arrow of the balloon will point to.</p></dd>
<dt>float <i class="arg">y</i></dt>
<dd><p>Y-coordinate of the point that the arrow of the balloon will point to.</p></dd>
<dt>string <i class="arg">text</i></dt>
<dd><p>Text to be drawn in the balloon.</p></dd>
<dt>string <i class="arg">dir</i></dt>
<dd><p>Direction of the arrow, one of: north, north-east, east, south-east,
south, south-west, west or north-west.</p></dd>
</dl></dd>
<dt><a name="44"><b class="cmd">$anyplot</b> balloonconfig <i class="arg">args</i></a></dt>
<dd><p>Configure the balloon text for the plot. The new settings will be used
for the next balloon text.</p>
<dl class="options">
<dt><b class="option">font</b> fontname</dt>
<dd><p>Font to be used for the text</p></dd>
<dt><b class="option">justify</b> left|center|right</dt>
<dd><p>Way to justify multiline text</p></dd>
<dt><b class="option">textcolour</b> colour</dt>
<dd><p>Colour for the text (synonym: textcolor)</p></dd>
<dt><b class="option">background</b> colour</dt>
<dd><p>Background colour for the balloon</p></dd>
<dt><b class="option">outline</b> colour</dt>
<dd><p>Colour of the outline of the balloon</p></dd>
<dt><b class="option">margin</b> value</dt>
<dd><p>Margin around the text (in pixels)</p></dd>
<dt><b class="option">rimwidth</b> value</dt>
<dd><p>Width of the outline of the balloon (in pixels)</p></dd>
<dt><b class="option">arrowsize</b> value</dt>
<dd><p>Length factor for the arrow (in pixels)</p></dd>
</dl></dd>
<dt><a name="45"><b class="cmd">$anyplot</b> plaintext <i class="arg">x</i> <i class="arg">y</i> <i class="arg">text</i> <i class="arg">dir</i></a></dt>
<dd><p>Add plain text to the plot (except for 3D plots). The text is positioned at
the given x- and y-coordinates. For xy-graphs and such, the
coordinates are directly related to the axes; for vertical barcharts the
x-coordinate is measured as the number of bars minus 1 and similar for
horizontal barcharts.</p>
<dl class="arguments">
<dt>float <i class="arg">x</i></dt>
<dd><p>X-coordinate of the text position</p></dd>
<dt>float <i class="arg">y</i></dt>
<dd><p>Y-coordinate of the text position</p></dd>
<dt>string <i class="arg">text</i></dt>
<dd><p>Text to be drawn.</p></dd>
<dt>string <i class="arg">dir</i></dt>
<dd><p>Anchor for the text, one of: north, north-east, east, south-east,
south, south-west, west or north-west.</p></dd>
</dl></dd>
<dt><a name="46"><b class="cmd">$anyplot</b> plaintextconfig <i class="arg">args</i></a></dt>
<dd><p>Configure the plain text annotation for the plot. The new settings will be used
for the next plain text.</p>
<dl class="options">
<dt><b class="option">font</b> fontname</dt>
<dd><p>Font to be used for the text</p></dd>
<dt><b class="option">justify</b> left|center|right</dt>
<dd><p>Way to justify multiline text</p></dd>
<dt><b class="option">textcolour</b> colour</dt>
<dd><p>Colour for the text (synonym: textcolor)</p></dd>
</dl></dd>
<dt><a name="47"><b class="cmd">$anyplot</b> object <i class="arg">itemtype</i> <i class="arg">series</i> <i class="arg">args</i></a></dt>
<dd><p>Draw a canvas item in the plot where the coordinates are scaled using the
coordinate system of the plot. In addition to the standard canvas types, it
also supports circles, dots and crosses.</p>
<p><em>Note:</em> Currently implemented for xy-plots, (vertical and horizontal)
barcharts, and piecharts.</p>
<p><em>Note:</em> To add an entry in the legend for the object, you can use the
<i class="term">dataconfig</i> subcommand with a type "rectangle". This will cause a rectangle
to be shown.</p>
<dl class="arguments">
<dt>string <i class="arg">itemtype</i> (in)</dt>
<dd><p>Name of a standard canvas item or "circle", "dot" or "cross"</p></dd>
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>The data series it belongs to, used for setting the default drawing options</p></dd>
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>List of coordinates and drawing options</p></dd>
</dl></dd>
<dt><a name="48"><b class="cmd">$anyplot</b> deletedata</a></dt>
<dd><p>Remove the lines, symbols and other graphical object associated with the
actual data from the plot.</p>
<p><em>Note:</em> Currently implemented for xy-plots only</p>
<p><em>Note:</em> The existing options for data series and the legend entry are
kept as they were.</p>
<p><em>Note:</em> Currently there are side effects if the canvas contains more than
one plot.</p></dd>
</dl>
<p><em>Note:</em> The commands <b class="method">xconfig</b> and <b class="method">yconfig</b> are
currently implemented only for XY-plots
and only the option <b class="option">-format</b> has any effect.</p>
<p>For <em>xy plots</em>, <em>stripcharts</em>, <em>histograms</em> and
<em>time-x-plots</em>:</p>
<dl class="definitions">
<dt><a name="49"><b class="cmd">$xyplot</b> plot <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></dt>
<dd><p>Add a data point to the plot.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the new point belongs to.</p></dd>
<dt>float <i class="arg">xcrd</i> (in)</dt>
<dd><p>X-coordinate of the new point. (For time-x plots this must be valid
date/time that can be read with the <em>clock scan</em> command).</p></dd>
<dt>float <i class="arg">ycrd</i> (in)</dt>
<dd><p>Y-coordinate of the new point.</p></dd>
</dl></dd>
</dl>
<p>For <em>xy plots</em> there is the additional command <em>plotlist</em>,
which is useful for plotting a large amount of data:</p>
<dl class="definitions">
<dt><a name="50"><b class="cmd">$xyplot</b> plotlist <i class="arg">series</i> <i class="arg">xlist</i> <i class="arg">ylist</i> <i class="arg">every</i></a></dt>
<dd><p>Draw a series of data as a whole. If symbols are asked for, draw them only
for every Nth data point.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the new point belongs to.</p></dd>
<dt>float <i class="arg">xlist</i> (in)</dt>
<dd><p>List of X-coordinates for the data series.</p></dd>
<dt>float <i class="arg">ycrd</i> (in)</dt>
<dd><p>List of Y-coordinates for the data series.</p></dd>
<dt>int <i class="arg">every</i> (in)</dt>
<dd><p>Optional argument stating how often a symbol (if any) should be drawn.
If left out, use a simple heuristic: N = sqrt(number of data points).</p></dd>
</dl></dd>
</dl>
<p><em>Note on histograms:</em></p>
<p>For histograms the x-coordinate that is given is interpreted to be
the x-coordinate of the <em>right</em> side of the bar (or line segment). The first
bar starts at the y-axis on the left. To completely fill the range
of the x-axis, you should draw a bar at the maximum x-coordinate.</p>
<p>For histograms you can also use the <b class="const">plotcumulative</b> command:</p>
<dl class="definitions">
<dt><a name="51"><b class="cmd">$histogram</b> plotcumulative <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></dt>
<dd></dd>
</dl>
<p>The arguments mean exactly the same as for the <b class="const">plot</b> command, but
the data are accumulated to the previous values.</p>
<p>For <em>xy plots</em>:</p>
<dl class="definitions">
<dt><a name="52"><b class="cmd">$xyplot</b> trend <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></dt>
<dd><p>Draw or update a trend line using the data given sofar.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the trend line belongs to.</p></dd>
<dt>float <i class="arg">xcrd</i> (in)</dt>
<dd><p>X-coordinate of the new data point</p></dd>
<dt>float <i class="arg">ycrd</i> (in)</dt>
<dd><p>Y-coordinate of the new data point</p></dd>
</dl></dd>
<dt><a name="53"><b class="cmd">$xyplot</b> rchart <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></dt>
<dd><p>Draw data in the same way as the plot method, but with two lines added
that indicate the expected range (+/- 3*standard deviation) of the data.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the data point belongs to.</p></dd>
<dt>float <i class="arg">xcrd</i> (in)</dt>
<dd><p>X-coordinate of the new data point</p></dd>
<dt>float <i class="arg">ycrd</i> (in)</dt>
<dd><p>Y-coordinate of the new data point</p></dd>
</dl></dd>
<dt><a name="54"><b class="cmd">$xyplot</b> interval <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ymin</i> <i class="arg">ymax</i> <span class="opt">?ycentr?</span></a></dt>
<dd><p>Add a vertical error interval to the plot. The interval is drawn from
ymin to ymax. If the ycentr argument is given, a symbol is drawn at that
position.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the interval belongs to.</p></dd>
<dt>float <i class="arg">xcrd</i> (in)</dt>
<dd><p>X-coordinate of the interval</p></dd>
<dt>float <i class="arg">ymin</i> (in)</dt>
<dd><p>Minimum y-coordinate of the interval.</p></dd>
<dt>float <i class="arg">ymax</i> (in)</dt>
<dd><p>Maximum y-coordinate of the interval.</p></dd>
<dt>float <i class="arg">ycentr</i> (in)</dt>
<dd><p>Y-coordinate to draw the symbol at (optional)</p></dd>
</dl></dd>
<dt><a name="55"><b class="cmd">$xyplot</b> box-and-whiskers <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></dt>
<dd><p>Draw a box and whiskers in the plot. If the argument <i class="term">xcrd</i> is a
list of
several values and the argument <i class="term">ycrd</i> is a single value, a
horizontal
box is drawn with the quartiles determined from the list of values
contained in <i class="term">xcrd</i>.</p>
<p>If, instead, the argument <i class="term">ycrd</i> contains a list of several values
and the argument <i class="term">xcrd</i> a single value, then a vertical box is
drawn and the quartiles are determined from <i class="term">ycrd</i>. (There must be
exactly one list of several values. Otherwise an error is reported.)</p>
<p>The option -boxwidth to the dataconfig command determines the width (or
height) of the box (default: 10 pixels).</p>
<p>The option -whiskers to the dataconfig command determines whether the
whiskers are drawn to the extreme values (value: extremes), to 1.5
times the interquartile range (value: IQR or iqr), or not at all (value: none).
If the value is 'IQR' (uppercase), then
also extreme values will be shown (from 1.5 to 3 times the IQR as dots,
above 3 times IQR as stars). If the value is 'iqr' (lowercase) no extreme
values will be shown (default value: IQR).</p>
<p>The option -whiskerwidth to the dataconfig command determines the thickness of the line
that draws the whiskers (default: 1 pixel).</p>
<p>The option -mediancolour to the dataconfig command determines the
colour of the line used to draw the median within the box (default: same as -colour).</p>
<p>The option -medianwidth to the dataconfig command determines the thickness of the line
that draws the median within the box (default: 1 pixel).</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the box-and-whiskers belongs to.</p></dd>
<dt>float <i class="arg">xcrd</i> (in)</dt>
<dd><p>X-coordinate of the box or a list of values.</p></dd>
<dt>float <i class="arg">ymin</i> (in)</dt>
<dd><p>Y-coordinate of the box or a list of values.</p></dd>
</dl>
<p>The box ends at the 1st and 3rd quartile, while the whiskers by default
are plotted to span 1.5 IQR (interquartile range) from the 1st and 3rd quartile.</p></dd>
<dt><a name="56"><b class="cmd">$xyplot</b> vector <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">ucmp</i> <i class="arg">vcmp</i></a></dt>
<dd><p>Draw a vector in the plot. The vector can be given as either cartesian
coordinates or as length/angle, where the angle is in degrees and is
interpreted according to the mathematical convention or the nautical.
(See the vectorconfig subcommand)</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the series the vector belongs to. Determines the appearance and
interpretation.</p></dd>
<dt>float <i class="arg">xcrd</i> (in)</dt>
<dd><p>X-coordinate of the point where the arrow appears</p></dd>
<dt>float <i class="arg">ycrd</i> (in)</dt>
<dd><p>Y-coordinate of the point where the arrow appears</p></dd>
<dt>float <i class="arg">ucmp</i> (in)</dt>
<dd><p>X-component or the length of the vector</p></dd>
<dt>float <i class="arg">ycentr</i> (in)</dt>
<dd><p>Y-component or the angle of the vector</p></dd>
</dl></dd>
<dt><a name="57"><b class="cmd">$xyplot</b> vectorconfig <i class="arg">series</i> <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>]
Set the vector drawing options for a particular series</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the series the vector belongs to.</p></dd>
</dl>
<p>The options can be one of the following:</p>
<dl class="options">
<dt><b class="option">colour</b></dt>
<dd><p>The colour of the arrow (default: black; synonym: color)</p></dd>
<dt><b class="option">scale</b> value</dt>
<dd><p>The scale factor used to convert the length of the
arrow into a number of pixels (default: 1.0)</p></dd>
<dt><b class="option">centred</b> onoff</dt>
<dd><p>Logical value indicating that the xy-coordinates
are to be used as the start of the arrow or as the centre (default: 0;
synonym: centered)</p></dd>
<dt><b class="option">type</b> keyword</dt>
<dd><p>Interpretation of the vector components. Can be "cartesian"
(default), in which case the x- and y-components are expected, "polar"
(the angle 0 coincides with the positive x-axis, 90 coincides with the
positive y-axis) or "nautical" (0 is "north" and 90 is "east").</p></dd>
</dl></dd>
<dt><a name="58"><b class="cmd">$xyplot</b> dot <i class="arg">series</i> <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">value</i></a></dt>
<dd><p>Draw a dot in the plot. The size and colour is determined by the value
and by the options set for the series it belongs to.
(See the dotconfig subcommand)</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the series the dot belongs to. Determines size and colour</p></dd>
<dt>float <i class="arg">xcrd</i> (in)</dt>
<dd><p>X-coordinate of the point where the arrow appears</p></dd>
<dt>float <i class="arg">ycrd</i> (in)</dt>
<dd><p>Y-coordinate of the point where the arrow appears</p></dd>
<dt>float <i class="arg">value</i> (in)</dt>
<dd><p>Value determining size and colour</p></dd>
</dl></dd>
<dt><a name="59"><b class="cmd">$xyplot</b> dotconfig <i class="arg">series</i> <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>]
Set the dot drawing options for a particular series</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the series the dot belongs to.</p></dd>
</dl>
<p>The options can be one of the following:</p>
<dl class="options">
<dt><b class="option">colour</b></dt>
<dd><p>The colour of the dot if no scaling is used or the value exceeds the
last limit of the classes.</p></dd>
<dt><b class="option">scale</b> value</dt>
<dd><p>The scale factor used to convert the value into the radius of the dot
in pixels (default: 1.0)</p></dd>
<dt><b class="option">radius</b> value</dt>
<dd><p>The default radius of the dots, used if there is no scaling by value
(in pixels; default: 3)</p></dd>
<dt><b class="option">scalebyvalue</b> onoff</dt>
<dd><p>Determines whether the dots all have the same size or a size depending
on the given value (default: on).</p></dd>
<dt><b class="option">outline</b> onoff</dt>
<dd><p>Draw a black circle around the dot or not (default: on)</p></dd>
<dt><b class="option">classes</b> list</dt>
<dd><p>Set the limits and the corresponding colours. For instance:</p>
<pre class="example">
$xyplot series1 -classes {0 blue 1 green} -colour red
</pre>
<p>will cause a blue dot to be drawn for values smaller than 0, a green dot
for values larger/equal 0 but lower than 1 and a red dot for values
larger/equal 1.</p></dd>
<dt><b class="option">3deffect</b> onoff</dt>
<dd><p>Show a highlight in the dots, to mimick a 3D effect (default: off)</p>
<p>If there is no list of classes for the particular series, the dots are
scaled by the value.</p>
<p>You can combine the colouring by value and the scaling by value by
setting a list of classes and setting the <em>scalebyvalue</em> option on.</p></dd>
</dl></dd>
<dt><a name="60"><b class="cmd">$xyplot</b> contourlines <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">values</i> <span class="opt">?classes?</span></a></dt>
<dd><p>Draw contour lines for the values given on the grid. The grid is defined
by the xcrd and ycrd arguments. The xcrd argument (resp. ycrd)
is expected to be a matrix, implemented as a list of lists which gives the
x-coordinates (resp. y-coordinates) of the grid cell corners.
The function values are given at these corners.
The number of rows in xvec (resp. yvec) is ny and each row contains nx values
so that the total number of values in xvec (resp. yvec) is nx * ny.
The classes determine which contour lines are drawn. If a value on one of
the corners is missing, the contour lines in that cell will not be
drawn.</p>
<p>Entries in the legend are drawn via the <em>legendisolines</em> subcommand.</p>
<dl class="arguments">
<dt>list <i class="arg">xcrd</i> (in)</dt>
<dd><p>List of lists, each value is an x-coordinate for a grid cell corner</p></dd>
<dt>list <i class="arg">ycrd</i> (in)</dt>
<dd><p>List of lists, each value is an y-coordinate for a grid cell corner</p></dd>
<dt>list <i class="arg">values</i> (in)</dt>
<dd><p>List of lists, each value is the value at a grid cell corner</p></dd>
<dt>list <i class="arg">classes</i> (in)</dt>
<dd><p>List of class values or a list of lists of two elements (each inner list
the class value and the colour to be used). If empty or missing, the
classes are determined automatically.</p>
<p><em>Note:</em> The class values must enclose the whole range of values.
<em>Note:</em> The xcrd argument is generally made of nypoints identical rows, while
each row of ycrd is made with one single value.</p></dd>
</dl></dd>
<dt><a name="61"><b class="cmd">$xyplot</b> contourlinesfunctionvalues <i class="arg">xvec</i> <i class="arg">yvec</i> <i class="arg">valuesmat</i> <span class="opt">?classes?</span></a></dt>
<dd><p>Draw contour lines for the values given on the grid. The grid is defined
by the xvec and yvec arguments. Here, xvec (resp. yvec) is a list of x-coordinates
(resp. y-coordinates). The number of values in xvec (resp. yvec) is the number of points in
the x-coordinate (resp. y-coordinate).
The function values are given at these corners. The
classes determine which contour lines are drawn. If a value on one of
the corners is missing, the contour lines in that cell will not be
drawn.</p>
<p>Entries in the legend are drawn via the <em>legendisolines</em> subcommand.</p>
<dl class="arguments">
<dt>list <i class="arg">xcrd</i> (in)</dt>
<dd><p>List of x-coordinates in increasing order.</p></dd>
<dt>list <i class="arg">ycrd</i> (in)</dt>
<dd><p>List y-coordinates in increasing order.</p></dd>
<dt>list <i class="arg">valuesmat</i> (in)</dt>
<dd><p>List of lists, each value is the value at a grid cell corner.
The total number of values is valuesmat is nx * ny.</p></dd>
<dt>list <i class="arg">classes</i> (in)</dt>
<dd><p>List of class values or a list of lists of two elements (each inner list
the class value and the colour to be used). If empty or missing, the
classes are determined automatically.</p>
<p><em>Note:</em> The class values must enclose the whole range of values.</p></dd>
</dl></dd>
<dt><a name="62"><b class="cmd">$xyplot</b> contourfill <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">values</i> <span class="opt">?classes?</span></a></dt>
<dd><p>Draw filled contours for the values given on the grid. (The use of this
method is identical to the "contourlines" method).</p>
<p>Entries in the legend are drawn via the <em>legendshades</em> subcommand.</p></dd>
<dt><a name="63"><b class="cmd">$xyplot</b> contourbox <i class="arg">xcrd</i> <i class="arg">ycrd</i> <i class="arg">values</i> <span class="opt">?classes?</span></a></dt>
<dd><p>Draw the cells as filled quadrangles. The colour is determined from
the average of the values on all four corners.</p>
<p>Entries in the legend are drawn via the <em>legendshades</em> subcommand.</p></dd>
<dt><a name="64"><b class="cmd">$xyplot</b> colorMap <i class="arg">colours</i></a></dt>
<dd><p>Set the colours to be used with the contour methods. The argument is
either a predefined colourmap (grey/gray, jet, hot or cool)
or a list of colours. When selecting the colours for actually drawing the
contours, the given colours will be interpolated (based on the HLS scheme).</p>
<dl class="arguments">
<dt>list <i class="arg">colours</i> (in)</dt>
<dd><p>List of colour names or colour values or one of the predefined maps:</p>
<ul class="itemized">
<li><p>grey or gray: gray colours from dark to light</p></li>
<li><p>jet: rainbow colours</p></li>
<li><p>hot: colours from yellow via red to darkred</p></li>
<li><p>cool: colours from cyan via blue to magenta</p></li>
</ul></dd>
</dl></dd>
<dt><a name="65"><b class="cmd">$xyplot</b> legendisolines <i class="arg">values</i> <i class="arg">classes</i></a></dt>
<dd><p>Add the contour classes to the legend as coloured lines. The text indicates the
values.</p>
<dl class="arguments">
<dt>list <i class="arg">values</i> (in)</dt>
<dd><p>The list of values as used for the actual drawing. This argument is used only
if the list of classes is empty.</p></dd>
<dt>list <i class="arg">values</i> (in)</dt>
<dd><p>The list of classes as used for the actual drawing.</p></dd>
</dl></dd>
<dt><a name="66"><b class="cmd">$xyplot</b> legendshades <i class="arg">values</i> <i class="arg">classes</i></a></dt>
<dd><p>Add the contour classes to the legend as coloured rectangles. The text indicates the
values.</p>
<dl class="arguments">
<dt>list <i class="arg">values</i> (in)</dt>
<dd><p>The list of values as used for the actual drawing. This argument is used only
if the list of classes is empty.</p></dd>
<dt>list <i class="arg">values</i> (in)</dt>
<dd><p>The list of classes as used for the actual drawing.</p></dd>
</dl></dd>
<dt><a name="67"><b class="cmd">$xyplot</b> grid <i class="arg">xcrd</i> <i class="arg">ycrd</i></a></dt>
<dd><p>Draw the grid cells as lines connecting the (valid) grid points.</p>
<dl class="arguments">
<dt>list <i class="arg">xcrd</i> (in)</dt>
<dd><p>List of lists, each value is an x-coordinate for a grid cell corner</p></dd>
<dt>list <i class="arg">ycrd</i> (in)</dt>
<dd><p>List of lists, each value is an y-coordinate for a grid cell corner</p></dd>
</dl></dd>
<dt><a name="68"><b class="cmd">$xyplot</b> xband <i class="arg">ymin</i> <i class="arg">ymax</i></a></dt>
<dd><p>Draw a light grey band in the plot, ranging over the full x-axis. This
can be used to indicate a "typical" range for the data.</p>
<dl class="arguments">
<dt>float <i class="arg">ymin</i> (in)</dt>
<dd><p>Lower bound for the band</p></dd>
<dt>float <i class="arg">ymax</i> (in)</dt>
<dd><p>Upper bound for the band</p></dd>
</dl></dd>
<dt><a name="69"><b class="cmd">$xyplot</b> yband <i class="arg">xmin</i> <i class="arg">xmax</i></a></dt>
<dd><p>Draw a light grey band in the plot, ranging over the full y-axis. This
can be used to indicate a "typical" range for the data.</p>
<dl class="arguments">
<dt>float <i class="arg">xmin</i> (in)</dt>
<dd><p>Lower bound for the band</p></dd>
<dt>float <i class="arg">xmax</i> (in)</dt>
<dd><p>Upper bound for the band</p></dd>
</dl></dd>
<dt><a name="70"><b class="cmd">$xyplot</b> labeldot <i class="arg">x</i> <i class="arg">y</i> <i class="arg">text</i> <i class="arg">orient</i></a></dt>
<dd><p>Draw a label and a symbol in the plot. The label will appear near the
symbol. The label will be drawn in grey, so as not to be too
conspicuous.</p>
<p>You can configure the appearance of the symbol by using the data series
name "labeldot":
<i class="term">$w dataconfig labeldot -colour red -type symbol -symbol dot</i></p>
<dl class="arguments">
<dt>float <i class="arg">x</i> (in)</dt>
<dd><p>X-coordinate of the symbol to be drawn</p></dd>
<dt>float <i class="arg">y</i> (in)</dt>
<dd><p>Y-coordinate of the symbol to be drawn</p></dd>
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>Text for the label</p></dd>
<dt>string <i class="arg">orient</i> (in)</dt>
<dd><p>Optional orientation (one of w, e, n, s) defining the position of the
label with respect to the symbol. It defaults to w (so the label
appears left of the symbol).</p></dd>
</dl></dd>
</dl>
<p>For <em>polar plots</em>:</p>
<dl class="definitions">
<dt><a name="71"><b class="cmd">$polarplot</b> plot <i class="arg">series</i> <i class="arg">radius</i> <i class="arg">angle</i></a></dt>
<dd><p>Add a data point to the polar plot.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the new point belongs to.</p></dd>
<dt>float <i class="arg">radius</i> (in)</dt>
<dd><p>Radial coordinate of the new point.</p></dd>
<dt>float <i class="arg">angle</i> (in)</dt>
<dd><p>Angular coordinate of the new point (in degrees).</p></dd>
</dl></dd>
</dl>
<p>For <em>wind rose diagrams</em>:</p>
<dl class="definitions">
<dt><a name="72"><b class="cmd">$windrose</b> plot <i class="arg">data</i> <i class="arg">colour</i></a></dt>
<dd><p>Draw the data contained in the <i class="term">data</i> argument. The data are added to
the existing spokes towards the outer circle.</p>
<dl class="arguments">
<dt>list <i class="arg">data</i> (in)</dt>
<dd><p>List of data (the length should correspond to the number of sectors)</p></dd>
<dt>string <i class="arg">colour</i></dt>
<dd><p>Colour in which the new segments will be drawn</p></dd>
</dl></dd>
</dl>
<p>For <em>3D plots</em>:</p>
<dl class="definitions">
<dt><a name="73"><b class="cmd">$plot3d</b> plotfunc <i class="arg">function</i></a></dt>
<dd><p>Plot a function defined over two variables <b class="variable">x</b> and <b class="variable">y</b>.
The resolution is determined by the set grid sizes (see the method
<b class="method">gridsize</b> for more information).</p>
<dl class="arguments">
<dt>string <i class="arg">function</i> (in)</dt>
<dd><p>Name of the procedure that calculates the z-value for the given x and
y coordinates. The procedure has to accept two float arguments (x is
first argument, y is second) and return a floating-point value.</p></dd>
</dl></dd>
<dt><a name="74"><b class="cmd">$plot3d</b> plotfuncont <i class="arg">function</i> <i class="arg">contours</i></a></dt>
<dd><p>Plot a function defined over two variables <b class="variable">x</b> and <b class="variable">y</b> using
the contour levels in <b class="variable">contours</b> to colour the surface.
The resolution is determined by the set grid sizes (see the method
<b class="method">gridsize</b> for more information).</p>
<dl class="arguments">
<dt>string <i class="arg">function</i> (in)</dt>
<dd><p>Name of the procedure that calculates the z-value for the given x and
y coordinates. The procedure has to accept two float arguments (x is
first argument, y is second) and return a floating-point value.</p></dd>
<dt>list <i class="arg">contours</i> (in)</dt>
<dd><p>List of values in ascending order that represent the contour levels
(the boundaries between the colours in the contour map).</p></dd>
</dl></dd>
<dt><a name="75"><b class="cmd">$plot3d</b> gridsize <i class="arg">nxcells</i> <i class="arg">nycells</i></a></dt>
<dd><p>Set the grid size in the two directions. Together they determine how
many polygons will be drawn for a function plot.</p>
<dl class="arguments">
<dt>int <i class="arg">nxcells</i> (in)</dt>
<dd><p>Number of grid cells in x direction. Has to be an integer number
greater than zero.</p></dd>
<dt>int <i class="arg">nycells</i> (in)</dt>
<dd><p>Number of grid cells in y direction. Has to be an integer number
greater than zero.</p></dd>
</dl></dd>
<dt><a name="76"><b class="cmd">$plot3d</b> plotdata <i class="arg">data</i></a></dt>
<dd><p>Plot a matrix of data.</p>
<dl class="arguments">
<dt>list <i class="arg">data</i> (in)</dt>
<dd><p>The data to be plotted. The data has to be provided as a nested list
with 2 levels. The outer list contains rows, drawn in y-direction, and
each row is a list whose elements are drawn in x-direction, for the
columns. Example:</p>
<pre class="example">
set data {
{1.0 2.0 3.0}
{4.0 5.0 6.0}
}
</pre>
</dd>
</dl></dd>
<dt><a name="77"><b class="cmd">$plot3d</b> colours <i class="arg">fill</i> <i class="arg">border</i></a></dt>
<dd><p>Configure the colours to use for polygon borders and inner area.</p>
<dl class="arguments">
<dt>color <i class="arg">fill</i> (in)</dt>
<dd><p>The colour to use for filling the polygons.</p></dd>
<dt>color <i class="arg">border</i> (in)</dt>
<dd><p>The colour to use for the border of the polygons.</p></dd>
</dl></dd>
<dt><a name="78"><b class="cmd">$plot3d</b> ribbon <i class="arg">yzpairs</i></a></dt>
<dd><p>Plot a ribbon based on the pairs of yz-coordinates. The colours for
the ribbon itself and the edge are taken from the colours option.</p>
<dl class="arguments">
<dt>list <i class="arg">yzpairs</i> (in)</dt>
<dd><p>List of pairs of yz-coordinates</p></dd>
</dl></dd>
</dl>
<p>For 3D ribbon plots:</p>
<dl class="definitions">
<dt><a name="79"><b class="cmd">$plot3d</b> plot <i class="arg">yzpairs</i></a></dt>
<dd><p>Plot a ribbon based on the pairs of yz-coordinates. The colours for
the ribbon itself and the edge are taken from the colours option.</p>
<dl class="arguments">
<dt>list <i class="arg">yzpairs</i> (in)</dt>
<dd><p>List of pairs of yz-coordinates</p></dd>
</dl></dd>
</dl>
<p>For <em>xy plots</em>, <em>stripcharts</em>, <em>histograms</em> and <em>polar plots</em>:</p>
<dl class="definitions">
<dt><a name="80"><b class="cmd">$xyplot</b> dataconfig <i class="arg">series</i> <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>Set the value for one or more options regarding the drawing of data of
a specific series.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series whose configuration we are changing.</p></dd>
</dl>
<p>The following options are allowed:</p>
<dl class="options">
<dt><b class="option">colour</b> c</dt>
<dd></dd>
<dt><b class="option">color</b> c</dt>
<dd><p>The colour to be used when drawing the data series.</p></dd>
<dt><b class="option">type</b> enum</dt>
<dd><p>The drawing mode chosen for the series.
This can be one of <b class="const">line</b>, <b class="const">symbol</b>, or <b class="const">both</b>.</p></dd>
<dt><b class="option">symbol</b> enum</dt>
<dd><p>What kind of symbol to draw. The value of this option is ignored when
the drawing mode <b class="const">line</b> was chosen. This can be one of
<b class="const">plus</b>, <b class="const">cross</b>, <b class="const">circle</b>, <b class="const">up</b> (triangle
pointing up), <b class="const">down</b> (triangle pointing down), <b class="const">dot</b>
(filled circle), <b class="const">upfilled</b> or <b class="const">downfilled</b> (filled
triangles).</p></dd>
<dt><b class="option">radius</b> integer</dt>
<dd><p>The size of the radius of the symbol. The total width of the symbol will be
2 times the radius size. The default radius is 4.</p></dd>
<dt><b class="option">width</b> integer</dt>
<dd><p>The width of the line (if drawn) or the width of the polygon outline (if -filled).</p></dd>
<dt><b class="option">filled</b> enum</dt>
<dd><p>Whether to fill the area above or below the data line or not. Can be one
of: <b class="const">no</b>, <b class="const">up</b> or <b class="const">down</b> (<span class="sectref"><a href="#section7">SPECIAL EFFECTS</a></span>)</p></dd>
<dt><b class="option">fillcolour</b> colour</dt>
<dd><p>Colour to use when filling the area associated with the data line.</p></dd>
<dt><b class="option">style</b> enum</dt>
<dd><p>The style to be used for histograms:</p>
<ul class="itemized">
<li><p><b class="const">filled</b>: Fill the area under the data points with bars (default)</p></li>
<li><p><b class="const">spike</b>: Draw vertical lines from the y-axis (lower boundary) to the data point</p></li>
<li><p><b class="const">symbol</b>: Draw a symbol at the data point</p></li>
<li><p><b class="const">plateau</b>: Draw a horizontal line at the height of the data point</p></li>
<li><p><b class="const">stair</b>: Draw a continuous stair-like line connecting the data points</p></li>
</ul></dd>
</dl></dd>
</dl>
<p>For <em>piecharts</em> and <em>spiral pies</em>:</p>
<dl class="definitions">
<dt><a name="81"><b class="cmd">$pie</b> plot <i class="arg">data</i></a></dt>
<dd><p>Fill a piechart.</p>
<dl class="arguments">
<dt>list <i class="arg">data</i> (in)</dt>
<dd><p>A list of pairs (labels and values). The values determine the relative
size of the circle segments. The labels are drawn beside the circle.</p></dd>
</dl></dd>
<dt><a name="82"><b class="cmd">$pie</b> colours <i class="arg">colour1</i> <i class="arg">colour2</i> ...</a></dt>
<dd><p>Set the colours to be used.</p>
<dl class="arguments">
<dt>color <i class="arg">colour1</i> (in)</dt>
<dd><p>The first colour.</p></dd>
<dt>color <i class="arg">colour2</i> (in)</dt>
<dd><p>The second colour, and so on.</p></dd>
</dl></dd>
<dt><a name="83"><b class="cmd">$pie</b> explode <i class="arg">segment</i></a></dt>
<dd><p>Explode a segment (that is: move one segment out of the circle). If the segment is
indicated as "auto", then you can click on a segment. This will be exploded instead of
any previously exploded segment.</p>
<dl class="arguments">
<dt>int <i class="arg">segment</i></dt>
<dd><p>The segment to be exploded or "auto" if you want to do this interactively.</p></dd>
</dl></dd>
</dl>
<p>For <em>radial charts</em>:</p>
<dl class="definitions">
<dt><a name="84"><b class="cmd">$radial</b> plot <i class="arg">data</i> <i class="arg">colour</i> <i class="arg">thickness</i></a></dt>
<dd><p>Draw a new line in the radial chart</p>
<dl class="arguments">
<dt>list <i class="arg">data</i> (in)</dt>
<dd><p>A list of data (one for each spoke). The values determine the distance
from the centre of the line connecting the spokes.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour for the line.</p></dd>
<dt>int <i class="arg">thickness</i> (in)</dt>
<dd><p>An optional argument for the thickness of the line.</p></dd>
</dl></dd>
<dt><a name="85"><b class="cmd">$pie</b> colours <i class="arg">colour1</i> <i class="arg">colour2</i> ...</a></dt>
<dd><p>Set the colours to be used.</p>
<dl class="arguments">
<dt>color <i class="arg">colour1</i> (in)</dt>
<dd><p>The first colour.</p></dd>
<dt>color <i class="arg">colour2</i> (in)</dt>
<dd><p>The second colour, and so on.</p></dd>
</dl></dd>
</dl>
<p>For <em>vertical barcharts</em>:</p>
<dl class="definitions">
<dt><a name="86"><b class="cmd">$barchart</b> plot <i class="arg">series</i> <i class="arg">ydata</i> <i class="arg">colour</i> <span class="opt">?dir?</span> <span class="opt">?brightness?</span></a></dt>
<dd><p>Add a data series to a barchart.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the series the values belong to.</p></dd>
<dt>list <i class="arg">ydata</i> (in)</dt>
<dd><p>A list of values, one for each x-axis label.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the bars.</p></dd>
<dt>string <i class="arg">dir</i> (in)</dt>
<dd><p>If given, "top-down" or "bottom-up", to indicate the direction in which the colour changes.
(If not given, a uniform colour is used).</p></dd>
<dt>string <i class="arg">brightness</i> (in)</dt>
<dd><p>If given, "bright" or "dark" (defaulting to "bright"). The colour will change to respectively
white or black, depending on the direction.</p></dd>
</dl></dd>
<dt><a name="87"><b class="cmd">$barchart</b> config <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>Set options for drawing the bars.</p>
<dl class="options">
<dt><b class="option">showvalues</b> boolean</dt>
<dd><p>Whether to show the values or not (above the bars)</p></dd>
<dt><b class="option">valuefont</b> newfont</dt>
<dd><p>Name of the font to use for the values</p></dd>
<dt><b class="option">valuecolour</b> colour</dt>
<dd><p>Colour for the values</p></dd>
<dt><b class="option">valueformat</b> format</dt>
<dd><p>Format string to use for formatting the values</p></dd>
</dl></dd>
</dl>
<p>For <em>horizontal barcharts</em>:</p>
<dl class="definitions">
<dt><a name="88"><b class="cmd">$barchart</b> plot <i class="arg">series</i> <i class="arg">xdata</i> <i class="arg">colour</i> <span class="opt">?dir?</span> <span class="opt">?brightness?</span></a></dt>
<dd><p>Add a data series to a barchart.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the series the values belong to.</p></dd>
<dt>list <i class="arg">xdata</i> (in)</dt>
<dd><p>A list of values, one for each y-axis label.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the bars.</p></dd>
<dt>string <i class="arg">dir</i> (in)</dt>
<dd><p>If given, "left-right" or "right-left", to indicate the direction in which the colour changes.
(If not given, a uniform colour is used).</p></dd>
<dt>string <i class="arg">brightness</i> (in)</dt>
<dd><p>If given, "bright" or "dark" (defaulting to "bright"). The colour will change to respectively
white or black, depending on the direction.</p></dd>
</dl></dd>
<dt><a name="89"><b class="cmd">$barchart</b> config <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>Set options for drawing the bars.</p>
<dl class="options">
<dt><b class="option">showvalues</b> boolean</dt>
<dd><p>Whether to show the values or not (to the right of the bars)</p></dd>
<dt><b class="option">valuefont</b> newfont</dt>
<dd><p>Name of the font to use for the values</p></dd>
<dt><b class="option">valuecolour</b> colour</dt>
<dd><p>Colour for the values</p></dd>
<dt><b class="option">valueformat</b> format</dt>
<dd><p>Format string to use for formatting the values</p></dd>
</dl></dd>
</dl>
<p>For <em>3D barcharts</em>:</p>
<dl class="definitions">
<dt><a name="90"><b class="cmd">$barchart</b> plot <i class="arg">label</i> <i class="arg">yvalue</i> <i class="arg">colour</i></a></dt>
<dd><p>Add the next bar to the barchart.</p>
<dl class="arguments">
<dt>string <i class="arg">label</i> (in)</dt>
<dd><p>The label to be shown below the column.</p></dd>
<dt>float <i class="arg">yvalue</i> (in)</dt>
<dd><p>The value that determines the height of the column</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the column.</p></dd>
</dl></dd>
<dt><a name="91"><b class="cmd">$barchart</b> config <b class="option">-option</b> <i class="arg">value</i> ...</a></dt>
<dd><p>Set one or more configuration parameters. The following options are
supported:</p>
<dl class="options">
<dt><b class="option">usebackground</b> boolean</dt>
<dd><p>Whether to draw walls to the left and to the back of the columns or not</p></dd>
<dt><b class="option">useticklines</b> boolean</dt>
<dd><p>Whether to draw ticklines on the walls or not</p></dd>
<dt><b class="option">showvalues</b> boolean</dt>
<dd><p>Whether to show the values or not</p></dd>
<dt><b class="option">labelfont</b> newfont</dt>
<dd><p>Name of the font to use for labels</p></dd>
<dt><b class="option">labelcolour</b> colour</dt>
<dd><p>Colour for the labels</p></dd>
<dt><b class="option">valuefont</b> newfont</dt>
<dd><p>Name of the font to use for the values</p></dd>
<dt><b class="option">valuecolour</b> colour</dt>
<dd><p>Colour for the values</p></dd>
</dl></dd>
</dl>
<p>For <em>3D ribbon charts</em>:</p>
<dl class="definitions">
<dt><a name="92"><b class="cmd">$ribbon</b> line <i class="arg">xypairs</i> <i class="arg">colour</i></a></dt>
<dd><p>Plot the given xy-pairs as a ribbon in the chart</p>
<dl class="arguments">
<dt>list <i class="arg">xypairs</i> (in)</dt>
<dd><p>The pairs of x/y values to be drawn (the series is drawn as a whole)</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the ribbon.</p></dd>
</dl></dd>
<dt><a name="93"><b class="cmd">$ribbon</b> area <i class="arg">xypairs</i> <i class="arg">colour</i></a></dt>
<dd><p>Plot the given xy-pairs as a ribbon with a filled area in front. The
effect is that of a box with the data as its upper surface.</p>
<dl class="arguments">
<dt>list <i class="arg">xypairs</i> (in)</dt>
<dd><p>The pairs of x/y values to be drawn (the series is drawn as a whole)</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the ribbon/area.</p></dd>
</dl></dd>
</dl>
<p>For <em>boxplots</em>:</p>
<dl class="definitions">
<dt><a name="94"><b class="cmd">$boxplot</b> plot <i class="arg">series</i> <i class="arg">label</i> <i class="arg">values</i></a></dt>
<dd><p>Add a box-and-whisker to the plot. The dataconfig command can be used to customize
the box-and-whisker (see the box-and-whiskers command for the xyplot for details).</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the data series the box belongs to</p></dd>
<dt>string <i class="arg">label</i> (in)</dt>
<dd><p>The label along the x- or y-axis to which the data belong</p></dd>
<dt>list <i class="arg">values</i> (in)</dt>
<dd><p>List of raw values, the extent of the box and the whiskers will be
determined from this list.</p></dd>
</dl></dd>
</dl>
<p>For <em>timecharts</em>:</p>
<dl class="definitions">
<dt><a name="95"><b class="cmd">$timechart</b> period <i class="arg">text</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">colour</i></a></dt>
<dd><p>Add a time period to the chart.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text describing the period.</p></dd>
<dt>string <i class="arg">time_begin</i> (in)</dt>
<dd><p>Start time of the period.</p></dd>
<dt>string <i class="arg">time_end</i> (in)</dt>
<dd><p>Stop time of the period.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the bar (defaults to black).</p></dd>
</dl></dd>
<dt><a name="96"><b class="cmd">$timechart</b> milestone <i class="arg">text</i> <i class="arg">time</i> <i class="arg">colour</i></a></dt>
<dd><p>Add a <i class="term">milestone</i> (represented as an point-down triangle) to the
chart.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text describing the milestone.</p></dd>
<dt>string <i class="arg">time</i> (in)</dt>
<dd><p>Time at which the milestone must be positioned.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the triangle (defaults to black).</p></dd>
</dl></dd>
<dt><a name="97"><b class="cmd">$timechart</b> vertline <i class="arg">text</i> <i class="arg">time</i></a></dt>
<dd><p>Add a vertical line (to indicate the start of the month for instance)
to the chart.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text appearing at the top (an abbreviation of the
date/time for instance).</p></dd>
<dt>string <i class="arg">time</i> (in)</dt>
<dd><p>Time at which the line must be positioned.</p></dd>
</dl></dd>
<dt><a name="98"><b class="cmd">$timechart</b> hscroll <i class="arg">scrollbar</i></a></dt>
<dd><p>Connect a horizontal scrollbar to the chart. See also the section on
scrolling.</p>
<dl class="arguments">
<dt>widget <i class="arg">scrollbar</i> (in)</dt>
<dd><p>The horizontal scrollbar that is to be connected to the chart</p></dd>
</dl></dd>
<dt><a name="99"><b class="cmd">$timechart</b> vscroll <i class="arg">scrollbar</i></a></dt>
<dd><p>Connect a vertical scrollbar to the chart. See also the section on
scrolling.</p>
<dl class="arguments">
<dt>widget <i class="arg">scrollbar</i> (in)</dt>
<dd><p>The vertical scrollbar that is to be connected to the chart</p></dd>
</dl></dd>
</dl>
<p>For <em>Gantt charts</em>:</p>
<dl class="definitions">
<dt><a name="100"><b class="cmd">$ganttchart</b> task <i class="arg">text</i> <i class="arg">time_begin</i> <i class="arg">time_end</i> <i class="arg">completed</i></a></dt>
<dd><p>Add a task with its period and level of completion to the chart. Returns
a list of canvas items that can be used for further manipulations, like
connecting two tasks.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text describing the task.</p></dd>
<dt>string <i class="arg">time_begin</i> (in)</dt>
<dd><p>Start time of the task.</p></dd>
<dt>string <i class="arg">time_end</i> (in)</dt>
<dd><p>Stop time of the task.</p></dd>
<dt>float <i class="arg">completed</i> (in)</dt>
<dd><p>The percentage of the task that is completed.</p></dd>
</dl></dd>
<dt><a name="101"><b class="cmd">$ganttchart</b> milestone <i class="arg">text</i> <i class="arg">time</i> <i class="arg">colour</i></a></dt>
<dd><p>Add a <i class="term">milestone</i> (represented as an point-down triangle) to the
chart.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text describing the milestone.</p></dd>
<dt>string <i class="arg">time</i> (in)</dt>
<dd><p>Time at which the milestone must be positioned.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the triangle (defaults to black).</p></dd>
</dl></dd>
<dt><a name="102"><b class="cmd">$ganttchart</b> vertline <i class="arg">text</i> <i class="arg">time</i></a></dt>
<dd><p>Add a vertical line (to indicate the start of the month for instance)
to the chart.</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text appearing at the top (an abbreviation of the
date/time for instance).</p></dd>
<dt>string <i class="arg">time</i> (in)</dt>
<dd><p>Time at which the line must be positioned.</p></dd>
</dl></dd>
<dt><a name="103"><b class="cmd">$ganttchart</b> connect <i class="arg">from</i> <i class="arg">to</i></a></dt>
<dd><p>Add an arrow that connects the <em>from</em> task with the <em>to</em> task.</p>
<dl class="arguments">
<dt>list <i class="arg">from</i> (in)</dt>
<dd><p>The list of items returned by the "task" command that represents the
task from which the arrow starts.</p></dd>
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text summarising the tasks</p></dd>
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>One or more tasks (the lists returned by the "task" command). They are
shifted down to make room for the summary.</p></dd>
<dt>list <i class="arg">to</i> (in)</dt>
<dd><p>The list of items returned by the "task" command that represents the
task at which the arrow ends.</p></dd>
</dl></dd>
<dt><a name="104"><b class="cmd">$ganttchart</b> summary <i class="arg">text</i> <i class="arg">args</i></a></dt>
<dd><p>Add a summary item that spans all the tasks listed. The graphical
representation is a thick bar running from the leftmost task to the
rightmost.</p>
<p>Use this command before connecting the tasks, as the arrow would not be
shifted down!</p>
<dl class="arguments">
<dt>string <i class="arg">text</i> (in)</dt>
<dd><p>The text summarising the tasks</p></dd>
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>One or more tasks (the lists returned by the "task" command). They are
shifted down to make room for the summary.</p></dd>
</dl></dd>
<dt><a name="105"><b class="cmd">$ganttchart</b> color <i class="arg">keyword</i> <i class="arg">newcolor</i></a></dt>
<dd><p>Set the colour of a part of the Gantt chart. These colours hold for all
items of that type.</p>
<dl class="arguments">
<dt>string <i class="arg">keyword</i> (in)</dt>
<dd><p>The keyword indicates which part of the Gantt chart to change:</p>
<ul class="itemized">
<li><p>description - the colour of the descriptive text</p></li>
<li><p>completed - the colour of the filled bar representing the completed part
of a task</p></li>
<li><p>left - the colour for the part that is not yet completed</p></li>
<li><p>odd - the background colour for the odd entries</p></li>
<li><p>even - the background colour for the even entries</p></li>
<li><p>summary - the colour for the summary text</p></li>
<li><p>summarybar - the colour for the bar for a summary</p></li>
</ul></dd>
<dt>string <i class="arg">newcolor</i> (in)</dt>
<dd><p>The new colour for the chosen items.</p></dd>
</dl></dd>
<dt><a name="106"><b class="cmd">$ganttchart</b> font <i class="arg">keyword</i> <i class="arg">newfont</i></a></dt>
<dd><p>Set the font of a part of the Gantt chart. These fonts hold for all
items of that type.</p>
<dl class="arguments">
<dt>string <i class="arg">keyword</i> (in)</dt>
<dd><p>The keyword indicates which part of the Gantt chart to change:</p>
<ul class="itemized">
<li><p>description - the font used for descriptive text</p></li>
<li><p>summary - the font used for summaries</p></li>
<li><p>scale - the font used for the time scale</p></li>
</ul></dd>
<dt>string <i class="arg">newfont</i> (in)</dt>
<dd><p>The new font for the chosen items.</p></dd>
</dl></dd>
<dt><a name="107"><b class="cmd">$ganttchart</b> hscroll <i class="arg">scrollbar</i></a></dt>
<dd><p>Connect a horizontal scrollbar to the chart. See also the section on
scrolling.</p>
<dl class="arguments">
<dt>widget <i class="arg">scrollbar</i> (in)</dt>
<dd><p>The horizontal scrollbar that is to be connected to the chart</p></dd>
</dl></dd>
<dt><a name="108"><b class="cmd">$ganttchart</b> vscroll <i class="arg">scrollbar</i></a></dt>
<dd><p>Connect a vertical scrollbar to the chart. See also the section on
scrolling.</p>
<dl class="arguments">
<dt>widget <i class="arg">scrollbar</i> (in)</dt>
<dd><p>The vertical scrollbar that is to be connected to the chart</p></dd>
</dl></dd>
</dl>
<p>For <em>isometric plots</em> (to be extended):</p>
<dl class="definitions">
<dt><a name="109"><b class="cmd">$isoplot</b> plot rectangle <i class="arg">x1</i> <i class="arg">y1</i> <i class="arg">x2</i> <i class="arg">y2</i> <i class="arg">colour</i></a></dt>
<dd><p>Plot the outlines of a rectangle.</p>
<dl class="arguments">
<dt>float <i class="arg">x1</i> (in)</dt>
<dd><p>Minimum x coordinate of the rectangle to be drawn.</p></dd>
<dt>float <i class="arg">y1</i> (in)</dt>
<dd><p>Minimum y coordinate of the rectangle.</p></dd>
<dt>float <i class="arg">x2</i> (in)</dt>
<dd><p>Maximum x coordinate of the rectangle to be drawn.</p></dd>
<dt>float <i class="arg">y2</i> (in)</dt>
<dd><p>Maximum y coordinate of the rectangle.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the rectangle.</p></dd>
</dl></dd>
<dt><a name="110"><b class="cmd">$isoplot</b> plot filled-rectangle <i class="arg">x1</i> <i class="arg">y1</i> <i class="arg">x2</i> <i class="arg">y2</i> <i class="arg">colour</i></a></dt>
<dd><p>Plot a rectangle filled with the given colour.</p>
<dl class="arguments">
<dt>float <i class="arg">x1</i> (in)</dt>
<dd><p>Minimum x coordinate of the rectangle to be drawn.</p></dd>
<dt>float <i class="arg">y1</i> (in)</dt>
<dd><p>Minimum y coordinate of the rectangle.</p></dd>
<dt>float <i class="arg">x2</i> (in)</dt>
<dd><p>Maximum x coordinate of the rectangle to be drawn.</p></dd>
<dt>float <i class="arg">y2</i> (in)</dt>
<dd><p>Maximum y coordinate of the rectangle.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the rectangle.</p></dd>
</dl></dd>
<dt><a name="111"><b class="cmd">$isoplot</b> plot circle <i class="arg">xc</i> <i class="arg">yc</i> <i class="arg">radius</i> <i class="arg">colour</i></a></dt>
<dd><p>Plot the outline of a circle.</p>
<dl class="arguments">
<dt>float <i class="arg">xc</i> (in)</dt>
<dd><p>X coordinate of the circle's centre.</p></dd>
<dt>float <i class="arg">yc</i> (in)</dt>
<dd><p>Y coordinate of the circle's centre.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the circle.</p></dd>
</dl></dd>
<dt><a name="112"><b class="cmd">$isoplot</b> plot filled-circle <i class="arg">xc</i> <i class="arg">yc</i> <i class="arg">radius</i> <i class="arg">colour</i></a></dt>
<dd><p>Plot a circle filled with the given colour.</p>
<dl class="arguments">
<dt>float <i class="arg">xc</i> (in)</dt>
<dd><p>X coordinate of the circle's centre.</p></dd>
<dt>float <i class="arg">yc</i> (in)</dt>
<dd><p>Y coordinate of the circle's centre.</p></dd>
<dt>color <i class="arg">colour</i> (in)</dt>
<dd><p>The colour of the circle.</p></dd>
</dl></dd>
</dl>
<p>For <em>tables</em> you can use the following subcommands:</p>
<dl class="definitions">
<dt><a name="113"><b class="cmd">$table</b> row <i class="arg">items</i></a></dt>
<dd><p>Draw a single row of items. The appearance of the items can be
controlled explicitly via the format command.</p>
<dl class="arguments">
<dt>list <i class="arg">items</i> (in)</dt>
<dd><p>List of text items to be drawn, one per column</p></dd>
</dl></dd>
<dt><a name="114"><b class="cmd">$table</b> separator</a></dt>
<dd><p>Draw a horizontal line to separate two rows</p></dd>
<dt><a name="115"><b class="cmd">$table</b> formatcommand <i class="arg">procname</i></a></dt>
<dd><p>Set the procedure that controls the formatting of items. By default
items are simply drawn as centered text.</p>
<dl class="arguments">
<dt>string <i class="arg">procname</i> (in)</dt>
<dd><p>Name of the procedure to be used. Its signature is:</p>
<pre class="example">
proc procname {table widget row column value} {...}
</pre>
<p>Use the cellconfigure subcommand to set the attributes per cell.</p></dd>
</dl></dd>
<dt><a name="116"><b class="cmd">$table</b> cellconfigure <i class="arg">args</i></a></dt>
<dd><p>Set the attributes for the next cell(s) to be drawn.</p>
<dl class="arguments">
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>Key-value pairs: -background sets the background colour of the cells,
-cell sets the foreground colour, -font sets the text font, -anchor sets
the position of the text within the cell and -justify controls the
layout of multiline text.</p></dd>
</dl></dd>
</dl>
<p>There are a number of public procedures that may be useful in specific
situations: <em>Pro memorie</em>.</p>
</div>
<div id="section4" class="section"><h2><a name="section4">COORDINATE TRANSFORMATIONS</a></h2>
<p>Besides the commands that deal with the plots and charts directly,
there are a number of commands that can be used to convert world
coordinates to pixels and vice versa.
These include:</p>
<dl class="definitions">
<dt><a name="117"><b class="cmd">::Plotchart::viewPort</b> <i class="arg">w</i> <i class="arg">pxmin</i> <i class="arg">pymin</i> <i class="arg">pxmax</i> <i class="arg">pymax</i></a></dt>
<dd><p>Set the viewport for window <i class="arg">w</i>. Should be used in cooperation
with <b class="cmd">::Plotchart::worldCoordinates</b>.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the window (canvas widget) in question.</p></dd>
<dt>float <i class="arg">pxmin</i> (in)</dt>
<dd><p>Left-most pixel coordinate.</p></dd>
<dt>float <i class="arg">pymin</i> (in)</dt>
<dd><p>Top-most pixel coordinate (remember: the vertical pixel coordinate
starts with 0 at the top!).</p></dd>
<dt>float <i class="arg">pxmax</i> (in)</dt>
<dd><p>Right-most pixel coordinate.</p></dd>
<dt>float <i class="arg">pymax</i> (in)</dt>
<dd><p>Bottom-most pixel coordinate.</p></dd>
</dl></dd>
<dt><a name="118"><b class="cmd">::Plotchart::worldCoordinates</b> <i class="arg">w</i> <i class="arg">xmin</i> <i class="arg">ymin</i> <i class="arg">xmax</i> <i class="arg">ymax</i></a></dt>
<dd><p>Set the extreme world coordinates for window <i class="arg">w</i>. The world
coordinates need not be in ascending order (i.e. xmin can be larger
than xmax, so that a reversal of the x-axis is achieved).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the window (canvas widget) in question.</p></dd>
<dt>float <i class="arg">xmin</i> (in)</dt>
<dd><p>X-coordinate to be mapped to left side of viewport.</p></dd>
<dt>float <i class="arg">ymin</i> (in)</dt>
<dd><p>Y-coordinate to be mapped to bottom of viewport.</p></dd>
<dt>float <i class="arg">xmax</i> (in)</dt>
<dd><p>X-coordinate to be mapped to right side of viewport.</p></dd>
<dt>float <i class="arg">ymax</i> (in)</dt>
<dd><p>Y-coordinate to be mapped to top side of viewport.</p></dd>
</dl></dd>
<dt><a name="119"><b class="cmd">::Plotchart::world3DCoordinates</b> <i class="arg">w</i> <i class="arg">xmin</i> <i class="arg">ymin</i> <i class="arg">zmin</i> <i class="arg">xmax</i> <i class="arg">ymax</i> <i class="arg">zmax</i></a></dt>
<dd><p>Set the extreme three-dimensional world coordinates for window
<i class="arg">w</i>. The world coordinates need not be in ascending order (i.e. xmin
can be larger than xmax, so that a reversal of the x-axis is
achieved).</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the window (canvas widget) in question.</p></dd>
<dt>float <i class="arg">xmin</i> (in)</dt>
<dd><p>X-coordinate to be mapped to front side of the 3D viewport.</p></dd>
<dt>float <i class="arg">ymin</i> (in)</dt>
<dd><p>Y-coordinate to be mapped to left side of the viewport.</p></dd>
<dt>float <i class="arg">zmin</i> (in)</dt>
<dd><p>Z-coordinate to be mapped to bottom of viewport.</p></dd>
<dt>float <i class="arg">xmax</i> (in)</dt>
<dd><p>X-coordinate to be mapped to back side of viewport.</p></dd>
<dt>float <i class="arg">ymax</i> (in)</dt>
<dd><p>Y-coordinate to be mapped to right side of viewport.</p></dd>
<dt>float <i class="arg">zmax</i> (in)</dt>
<dd><p>Z-coordinate to be mapped to top side of viewport.</p></dd>
</dl></dd>
<dt><a name="120"><b class="cmd">::Plotchart::coordsToPixel</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i></a></dt>
<dd><p>Return a list of pixel coordinates valid for the given window.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the canvas alias (as returned by [\$anyplot canvas]) in question.</p></dd>
<dt>float <i class="arg">x</i> (in)</dt>
<dd><p>X-coordinate to be mapped.</p></dd>
<dt>float <i class="arg">y</i> (in)</dt>
<dd><p>Y-coordinate to be mapped.</p></dd>
</dl></dd>
<dt><a name="121"><b class="cmd">::Plotchart::coords3DToPixel</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i> <i class="arg">z</i></a></dt>
<dd><p>Return a list of pixel coordinates valid for the given window.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the canvas alias (as returned by [\$anyplot canvas]) in question.</p></dd>
<dt>float <i class="arg">x</i> (in)</dt>
<dd><p>X-coordinate to be mapped.</p></dd>
<dt>float <i class="arg">y</i> (in)</dt>
<dd><p>Y-coordinate to be mapped.</p></dd>
<dt>float <i class="arg">y</i> (in)</dt>
<dd><p>Z-coordinate to be mapped.</p></dd>
</dl></dd>
<dt><a name="122"><b class="cmd">::Plotchart::polarCoordinates</b> <i class="arg">w</i> <i class="arg">radmax</i></a></dt>
<dd><p>Set the extreme polar coordinates for window <i class="arg">w</i>. The angle always
runs from 0 to 360 degrees and the radius starts at 0. Hence you only
need to give the maximum radius.
<em>Note:</em> If the viewport is not square, this procedure will not
adjust the extremes, so that would result in an elliptical plot. The
creation routine for a polar plot always determines a square viewport.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the canvas alias (as returned by [\$anyplot canvas]) in question.</p></dd>
<dt>float <i class="arg">radmax</i> (in)</dt>
<dd><p>Maximum radius.</p></dd>
</dl></dd>
<dt><a name="123"><b class="cmd">::Plotchart::polarToPixel</b> <i class="arg">w</i> <i class="arg">rad</i> <i class="arg">phi</i></a></dt>
<dd><p>Wrapper for a call to <b class="cmd">::Plotchart::coordsToPixel</b>, which assumes
the world coordinates and viewport are set appropriately. Converts
polar coordinates to pixel coordinates.
<em>Note:</em> To be useful it should be accompanied by a matching
<b class="cmd">::Plotchart::worldCoordinates</b> procedure. This is automatically
taken care of in the creation routine for polar plots.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the canvas alias (as returned by [\$anyplot canvas]) in question.</p></dd>
<dt>float <i class="arg">rad</i> (in)</dt>
<dd><p>Radius of the point.</p></dd>
<dt>float <i class="arg">phi</i> (in)</dt>
<dd><p>Angle to the positive x-axis.</p></dd>
</dl></dd>
<dt><a name="124"><b class="cmd">::Plotchart::pixelToCoords</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i></a></dt>
<dd><p>Return a list of world coordinates valid for the given window.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the canvas alias (as returned by [\$anyplot canvas]) in question.</p></dd>
<dt>float <i class="arg">x</i> (in)</dt>
<dd><p>X-pixel to be mapped.</p></dd>
<dt>float <i class="arg">y</i> (in)</dt>
<dd><p>Y-pixel to be mapped.</p></dd>
</dl></dd>
<dt><a name="125"><b class="cmd">::Plotchart::pixelToIndex</b> <i class="arg">w</i> <i class="arg">x</i> <i class="arg">y</i></a></dt>
<dd><p>Return the index of the pie segment containing the pixel coordinates
(x,y)</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the canvas alias (as returned by [\$anyplot canvas]) in question,
holding a piechart.</p></dd>
<dt>float <i class="arg">x</i> (in)</dt>
<dd><p>X-pixel to be mapped.</p></dd>
<dt>float <i class="arg">y</i> (in)</dt>
<dd><p>Y-pixel to be mapped.</p></dd>
</dl></dd>
</dl>
<p>Furthermore there is a routine to determine "pretty" numbers for use
with an axis:</p>
<dl class="definitions">
<dt><a name="126"><b class="cmd">::Plotchart::determineScale</b> <i class="arg">xmin</i> <i class="arg">xmax</i> <i class="arg">inverted</i></a></dt>
<dd><p>Determine "pretty" numbers from the given range and return a list
containing the minimum, maximum and stepsize that can be used for a
(linear) axis.</p>
<dl class="arguments">
<dt>float <i class="arg">xmin</i> (in)</dt>
<dd><p>Rough minimum value for the scaling</p></dd>
<dt>float <i class="arg">xmax</i> (in)</dt>
<dd><p>Rough maximum value for the scaling.</p></dd>
<dt>boolean <i class="arg">inverted</i> (in)</dt>
<dd><p>Optional argument: if 1, then the returned list produces an
inverted axis. Defaults to 0 (the axis will be from minimum to maximum)</p></dd>
</dl></dd>
<dt><a name="127"><b class="cmd">::Plotchart::determineScaleFromList</b> <i class="arg">values</i> <i class="arg">inverted</i></a></dt>
<dd><p>Determine "pretty" numbers from the given list of values and return a list
containing the minimum, maximum and stepsize that can be used for a
(linear) axis.</p>
<dl class="arguments">
<dt>float <i class="arg">values</i> (in)</dt>
<dd><p>List of values that will be examined. May contain missing values (empty strings)</p></dd>
<dt>boolean <i class="arg">inverted</i> (in)</dt>
<dd><p>Optional argument: if 1, then the returned list produces an
inverted axis. Defaults to 0 (the axis will be from minimum to maximum)</p></dd>
</dl></dd>
</dl>
</div>
<div id="section5" class="section"><h2><a name="section5">MISSING VALUES</a></h2>
<p>Often data that need to be plotted contain gaps - in a series of
measurement data, they can occur because the equipment failed, a sample
was not collected correctly or for many other reasons. The
<em>Plotchart</em> handles these gaps by assuming that one or both
coordinates of such data points are an empty string:</p>
<pre class="example">
#
# Create the plot with its x- and y-axes
#
set s [::Plotchart::createXYPlot .c {0.0 100.0 10.0} {0.0 100.0 20.0}]
foreach {x y} {0.0 32.0 10.0 {} 25.0 60.0 78.0 11.0 } {
$s plot series1 $x $y
}
</pre>
<p>The effect varies according to the type of plot:</p>
<ul class="itemized">
<li><p>For xy-plots, radial plots and strip charts the missing data point
causes a gap in the line through the points.</p></li>
<li><p>For barchats, missing values are treated as if a value of zero was
given.</p></li>
<li><p>For time charts and Gantt charts missing values cause errors - there is
no use for them there.</p></li>
</ul>
</div>
<div id="section6" class="section"><h2><a name="section6">OTHER OUTPUT FORMATS</a></h2>
<p>Besides output to the canvas on screen, the module is capable, via
<b class="cmd">canvas postscript</b>, of producing PostScript files. One may wonder
whether it is possible to extend this set of output formats and the
answer is "yes". This section tries to sum up the aspects of using this
module for another sort of output.</p>
<p>One way you can create output files in a different format, is by
examining the contents of the canvas after everything has been drawn and
render that contents in the right form. This is probably the easiest
way, as it involves nothing more than the re-creation of all the
elements in the plot that are already there.</p>
<p>The drawback of that method is that you need to have a display, which is
not always the case if you run a CGI server or something like that.</p>
<p>An alternative is to emulate the canvas command. For this to work, you
need to know which canvas subcommands are used and what for. Obviously,
the <em>create</em> subcommand is used to create the lines, texts and
other items. But also the <em>raise</em> and <em>lower</em> subcommands are
used, because with these the module can influence the drawing order -
important to simulate a clipping rectangle around the axes. (The routine
DrawMask is responsible for this - if the output format supports proper
clipping areas, then a redefinition of this routine might just solve
this).</p>
<p>Furthermore, the module uses the <em>cget</em> subcommand to find out the
sizes of the canvas. A more mundane aspect of this is that the module
currently assumes that the text is 14 pixels high and that 80 pixels in
width suffice for the axis' labels. No "hook" is provided to customise
this.</p>
<p>In summary:</p>
<ul class="itemized">
<li><p>Emulate the <em>create</em> subcommand to create all the items in the
correct format</p></li>
<li><p>Emulate the <em>cget</em> subcommand for the options -width and -height to
allow the correct calculation of the rectangle's position and size</p></li>
<li><p>Solve the problem of <em>raising</em> and <em>lowering</em> the items so
that they are properly clipped, for instance by redefining the
routine DrawMask.</p></li>
<li><p>Take care of the currently fixed text size properties</p></li>
</ul>
</div>
<div id="section7" class="section"><h2><a name="section7">SPECIAL EFFECTS</a></h2>
<p>As an example of some special effects you can achieve, here is the
code for a plot where the area below the data line varies in colour:</p>
<pre class="example">
canvas .c -background white -width 400 -height 200
pack .c -fill both
set s [::Plotchart::createXYPlot .c {0.0 100.0 10.0} {0.0 100.0 20.0}]
$s background gradient green top-down
$s dataconfig series1 -filled up -fillcolour white
$s plot series1 0.0 20.0
$s plot series1 10.0 20.0
$s plot series1 30.0 50.0
$s plot series1 35.0 45.0
$s plot series1 45.0 25.0
$s plot series1 75.0 55.0
$s plot series1 100.0 55.0
$s plaintext 30.0 60.0 "Peak" south
</pre>
<p>The trick is to fill the background with a colour that changes from
green at the top to white at the bottom. Then the area above the data
line is filled with a white polygon. Thus the green shading varies with
the height of the line.</p>
</div>
<div id="section8" class="section"><h2><a name="section8">ROOM FOR IMPROVEMENT</a></h2>
<p>In this version there are a lot of things that still need to
be implemented:</p>
<ul class="itemized">
<li><p>More robust handling of incorrect calls (right now the procedures may
fail when called incorrectly):</p>
<ul class="itemized">
<li><p>The axis drawing routines can not handle inverse axes right now.</p></li>
<li><p>If the user provides an invalid date/time string, the routines simply
throw an error.</p></li>
</ul>
</li>
</ul>
</div>
<div id="section9" class="section"><h2><a name="section9">RESIZING</a></h2>
<p><b class="package">Plotchart</b> has not been designed to create plots and charts
that keep track of the data that are put in. This means that if an
application needs to allow the user to resize the window holding the
plot or chart, it must take care to redraw the complete plot.</p>
<p>The code below is a simple example of how to do that:</p>
<pre class="example">
package require Plotchart
grid [canvas .c -background white] -sticky news
grid columnconfigure . 0 -weight 1
grid rowconfigure . 0 -weight 1
bind .c <Configure> {doResize}
proc doPlot {} {
#
# Clean up the contents (see also the note below!)
#
.c delete all
#
# (Re)draw the bar chart
#
set p [::Plotchart::createBarchart .c {x y z} {0 100 10} 3]
$p plot R {10 30 40} red
$p plot G {30 40 60} green
}
proc doResize {} {
global redo
#
# To avoid redrawing the plot many times during resizing,
# cancel the callback, until the last one is left.
#
if { [info exists redo] } {
after cancel $redo
}
set redo [after 50 doPlot]
}</pre>
<p><em>Please note:</em>
The code above will work fine for barcharts and many other types of
plots, but as <b class="package">Plotchart</b> keeps some private information for
xy plots, more is needed in these cases. This actually requires a
command "destroyPlot" to take care of such details. A next version
of <b class="package">Plotchart</b> may have that.</p>
<p>Alternatively, you can use the <b class="package">xyplot</b> package which is built
on top of Plotchart. This package supports zooming in and zooming out,
as well as resizing the plot as a whole. Here is a small demonstration
program:</p>
<pre class="example">
# xyplot_demo.tcl --
# Demonstration of the xyplot package
#
package require xyplot
set xydata1 {}
set xydata2 {}
set xydata3 {}
set xydata4 {}
for { set i 0 } { $i < 1024 } { incr i } {
lappend xydata1 [expr {$i-1000}] [expr {$i * sin($i/4096.0*3.1415*2) * (sin($i/256.0*3.1415*2))}]
lappend xydata2 [expr {$i-1000}] [expr {$i * sin($i/4096.0*3.1415*2) * (sin($i/256.0*3.1415*2) + 0.25 * sin($i/256.0*3.1415*6))}]
lappend xydata3 [expr {$i-1000}] [expr {$i * sin($i/4096.0*3.1415*2) * (sin($i/256.0*3.1415*2) + 0.25 * sin($i/256.0*3.1415*6) + 0.0625 * sin($i/256.0*3.1415*10))}]
lappend xydata4 [expr {$i-1000}] [expr {$i * sin($i/4096.0*3.1415*2) * (sin($i/256.0*3.1415*2) + 0.25 * sin($i/256.0*3.1415*6) + 0.0625 * sin($i/256.0*3.1415*10) + 0.015625 * sin($i/256.0*3.1415*14))}]
}
set xyp [xyplot .xyp -xformat "%5.0f" -yformat "%5.0f" -title "XY plot testing" -background gray90]
pack $xyp -fill both -expand true
set s1 [$xyp add_data sf1 $xydata1 -legend "Serie 1 data" -color red]
set s2 [$xyp add_data sf2 $xydata2 -legend "Serie 2 data" -color green]
set s3 [$xyp add_data sf3 $xydata3 -legend "Serie 3 data" -color blue]
set s4 [$xyp add_data sf4 $xydata4 -legend "Serie 4 data" -color orange]
set xyp2 [xyplot .xyp2 -xticks 8 -yticks 4 -yformat %.2f -xformat %.0f]
pack $xyp2 -fill both -expand true
set s1 [$xyp2 add_data sf1 $xydata1]
set s2 [$xyp2 add_data sf2 $xydata2]
set s3 [$xyp2 add_data sf3 $xydata3]
set s4 [$xyp2 add_data sf4 $xydata4]
</pre>
<p>Zooming in is done by selecting a rectangle with the left mouse button
pressed. Zooming out is done by pressing the right mouse button. If you
resize the window, the canvases inside are resized too. If you zoom in,
you can scroll the plot via the scrollbars that are automatically
attached.</p>
</div>
<div id="section10" class="section"><h2><a name="section10">ZOOMING IN</a></h2>
<p>As the Plotchart package does not keep track of the data itself,
rescaling an existing plot - for instance when zooming in - would have
to be done by redefining the plot and redrawing the data. However, the
canvas widget offers a way out by scaling and moving items, so that
zooming in becomes a bit simpler.</p>
<p>Whether zooming is indeed useful, depends on the type of plot. Currently
it is defined for XY-plots only. The method is called "rescale" and
simply redraws the axes and scales and moves the data items so that they
conform to the new axes. The drawback is that any symbols are scaled by
the same amount. The rescale method works best for plots that only have
lines, not symbols.</p>
<p>The method works very simply:</p>
<pre class="example">
$p rescale {newxmin newxmax newxstep} {newymin newymax newystep}
</pre>
</div>
<div id="section11" class="section"><h2><a name="section11">CONFIGURATION OPTIONS</a></h2>
<p>The commands <b class="cmd">plotconfig</b> and <b class="cmd">plotstyle</b> can be used to set all
manner of options. The syntax is:</p>
<dl class="definitions">
<dt><a name="128"><b class="cmd">::Plotchart::plotconfig</b> <i class="arg">charttype</i> <i class="arg">component</i> <i class="arg">property</i> <i class="arg">value</i></a></dt>
<dd><p>Set a new value for the property of a component in a particular chart or
plot type or query its current value. Changed properties only have effect for
the consecutive plots, not for the ones already created. Each argument is optional.</p>
<p><em>Note:</em> The <b class="cmd">plotstyle</b> command offers a more
flexible way to control the configuration options.</p>
<dl class="arguments">
<dt>string <i class="arg">charttype</i> (in)</dt>
<dd><p>The type of chart or plot (see the configuration type that is mentioned
for each create command). If not given or empty, a list of chart types
is returned. If it is given, the properties for that particular type are
used.</p></dd>
<dt>string <i class="arg">component</i> (in)</dt>
<dd><p>The component of the plot/chart: leftaxis, rightaxis, background, margin
and so on. If not given or empty, a list of components is returned. If
it is given, the properties for that particular component will be set
for that particular type of chart.</p></dd>
<dt>string <i class="arg">property</i> (in)</dt>
<dd><p>The property of the component of the plot/chart: textcolor, thickness of
the axis line, etc. If not given or empty, a list of properties is returned. If
it is given, that particular property for that particular component
will be set for that particular type of chart.</p></dd>
<dt>string <i class="arg">value</i> (in)</dt>
<dd><p>The new value for the property. If empty, the current value is returned.
If the value is "default", the default value will be restored.</p>
<p>Note, that in some cases an empty value is useful. Use "none" in this
case - it can be useful for colours and for formats.</p></dd>
</dl></dd>
<dt><a name="129"><b class="cmd">::Plotchart::plotstyle</b> <i class="arg">subcmd</i> <i class="arg">style</i> <i class="arg">args</i></a></dt>
<dd><p>Manipulate the <em>style</em> in which subsequent plots will be drawn. The
default style is "default", but you can define and load any number of
other styles.</p>
<dl class="arguments">
<dt>string <i class="arg">subcmd</i> (in)</dt>
<dd><p>The subcommand to be executed:</p>
<ul class="itemized">
<li><p><em>configure</em> - this subcommand allows you to set the options per chart type.
It takes the same options as the <b class="cmd">plotconfig</b> command.</p></li>
<li><p><em>current</em> - return the current style</p></li>
<li><p><em>load</em> - make the given style the active style for subsequent plots and charts</p></li>
<li><p><em>names</em> - return the list of currently defined styles</p></li>
</ul></dd>
<dt>string <i class="arg">style</i> (in)</dt>
<dd><p>The name of the plot style to manipulate</p></dd>
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>The new options for the style - see the <b class="cmd">plotconfig</b> command for details</p></dd>
</dl></dd>
</dl>
<p>Below is a detailed list of the components and properties:</p>
<ul class="itemized">
<li><p>Axes come in a wide variety:</p>
<ul class="itemized">
<li><p>leftaxis, rightaxis, topaxis, bottomaxis for the plots with a
rectangular shape.</p></li>
<li><p>xaxis, yaxis and zaxis are used for the 3D plots</p></li>
<li><p>axis, this represents the radial and tangential axes of a polar plot</p></li>
</ul>
<p>All axes have the following properties:</p>
<ul class="itemized">
<li><p>color - the colour of the line and the tickmarks</p></li>
<li><p>thickness - the width of the line of the axis itself, not the tickmarks</p></li>
<li><p>ticklength - the length of the tickmarks in pixels. A positive value is
outward, a negative value is inward.</p></li>
<li><p>font - the font for the labels and the text at the axis</p></li>
<li><p>format - the format for rendering the (numerical) labels. For the time
axis it is the format for a date and time.</p></li>
<li><p>textcolor - the colour for the labels and the text.</p></li>
<li><p>labeloffset - space (in pixels) between the tickmark and the actual label</p></li>
<li><p>minorticks - number of minor tickmarks between the major tickmarks</p></li>
<li><p>shownumbers - show the numbers/labels or not.</p></li>
<li><p>showaxle - show the axis line or not.</p></li>
</ul>
</li>
<li><p>The <em>margin</em> is important for the layout. Currently only the
rectangular plots allow the margins to be set: left, right, top and bottom.
The values are in pixels.</p></li>
<li><p>The <em>text</em> component is meant for any text appearing via the
plaintext subcommand. The properties are: textcolor, font and anchor
(positioning of the text relative to the given coordinates).</p></li>
<li><p>The <em>background</em> has two properties: outercolor, the colour outside
of the actual plot, and innercolor, the colour inside the plot. (Note:
only "outercolor" has now been implemented).</p></li>
<li><p>The <em>mask</em> has one property only: draw. If set to 1, the default, white rectangles
are drawn to mimick the effects of clipping - excess data are made invisible this way.
Otherwise these rectangles are not drawn. This is useful to control
the layout more tightly, for instance with multiple plots in one canvas.</p></li>
<li><p>The <em>title</em> component has the same properties as the <em>text</em> component
(but it is independent of that component). It also has a <em>background</em> property:
If not set (or set to the empty string) this is the same as the outercolor property
of the <em>background</em> component, otherwise it is a separate colour.</p></li>
<li><p>The <em>legend</em> has three properties: background, border and position.
See the legend subcommand for the meaning.</p></li>
<li><p>The <em>bar</em> components is used for all barchart-like plots and has
three properties: <em>barwidth</em> (relative width of the bars in
relation to the items along the axis), <em>innermargin</em> (the
relative width of the gaps between bars or groups of bars) and
the <em>outline</em> colour.</p></li>
<li><p>The <em>labels</em> component is used to describe the appearance of the
labels of piecharts and "spiral" piecharts. The properties are:</p>
<ul class="itemized">
<li><p>textcolor - colour of the label text</p></li>
<li><p>font - font to be used for the label text</p></li>
<li><p>placement - <em>out</em> of the circle or <em>in</em> the circle</p></li>
<li><p>sorted - the data are sorted in ascending order first</p></li>
<li><p>shownumbers - the labels are combined with the numbers according to the
format</p></li>
<li><p>format - the format to be used (defaults to: "%s (%g)")
if the numbers are to shown. The format command gets the label first,
then the number)</p></li>
<li><p>formatright - if given, the format to be used for labels and numbers
appearing to the right of the pie. The format command gets the
number first, then the label. (Defaults to "")</p></li>
</ul>
</li>
<li><p>The <em>slice</em> component has properties to control the appearance of
the sections in the pie diagram:</p>
<ul class="itemized">
<li><p>outline - the colour of the line around the slices (default: black)</p></li>
<li><p>outlinewidth - width of the line around the slices (default: 1 pixel)</p></li>
<li><p>startangle - the angle w.r.t. positive x-axis where the first slice
starts</p></li>
<li><p>direction - the direction in which to draw the slices (default: +, that
is clockwise)</p></li>
</ul>
</li>
<li><p>The table charts use the general components <em>title</em> and <em>margin</em>
and further more the specific components <em>header</em>, <em>oddrow</em>,
<em>evenrow</em>, <em>cell</em> and <em>frame</em>:</p>
<ul class="itemized">
<li><p><em>header</em>, <em>oddrow</em> and <em>evenrow</em> have the properties:
<em>background</em>, <em>font</em>, <em>color</em>, <em>height</em> and
<em>anchor</em> with obvious meanings.</p></li>
<li><p>The <em>cell</em> component defines in addition <em>leftspace</em>,
<em>rightspace</em> and <em>topspace</em> for fine-grained control of the spacing
inside the cell. These are not set via the <i class="term">cellconfigure</i>
subcommand however.</p></li>
<li><p>Finally the <em>frame</em> component uses <em>color</em>, <em>outerwidth</em>
(for the width of the line surrounding the whole table) and
<em>innerwidth</em> (for the width of lines separating columns and rows).</p></li>
</ul>
</li>
</ul>
<p>See the examples in plotdemos7.tcl for its use.</p>
</div>
<div id="section12" class="section"><h2><a name="section12">SCROLLING FOR TIMECHARTS AND GANTT CHARTS</a></h2>
<p>For two types of plots automatic scrolling management has been
implemented: timecharts and Gantt charts. The subcommands <i class="term">hscroll</i>
and <i class="term">vscroll</i> associate (existing) scrollbars to the plot, in much
the same way as for text and canvas widgets.</p>
<p>Once the association is made, the scrollbars are automatically
updated if:</p>
<ul class="itemized">
<li><p>You add an item with a period wider than the current one.</p></li>
<li><p>You add a vertical line for a time beyond the current bounds.</p></li>
<li><p>You add an extra item beyond the number that was used to create the
chart.</p></li>
</ul>
<p>For instance:</p>
<pre class="example">
package require Plotchart
canvas .c -width 400 -height 200
scrollbar .y -orient vertical
scrollbar .x -orient horizontal
grid .c .y -sticky news
grid .x -sticky news
source plotchart.tcl
set s [::Plotchart::createTimechart .c "1 january 2004" "31 december 2004" 4]
$s period "Spring" "1 march 2004" "1 june 2004" green
$s period "Summer" "1 june 2004" "1 september 2004" yellow
$s vertline "1 jan" "1 january 2004"
$s vertline "1 apr" "1 april 2004"
$s vertline "1 jul" "1 july 2004"
$s vertline "1 oct" "1 october 2004"
$s vertline "1 jan" "1 january 2005"
$s vertline "1 apr" "1 april 2005"
$s vertline "1 jul" "1 july 2005"
$s milestone "Longest day" "21 july 2004"
$s milestone "Longest day 2" "21 july 2004"
$s milestone "Longest day 3" "21 july 2004"
$s milestone "Longest day 4" "21 july 2004"
$s milestone "Longest day 5" "21 july 2004"
$s milestone "Longest day 6" "21 july 2004"
$s title "Seasons (northern hemisphere)"
$s vscroll .y
$s hscroll .x
</pre>
<p>The original extent of the chart is from 1 january 2004 to 31 december
2004. But because of the addition of vertical lines in 2005 and
more items than was specified at the creation of the chart, both the
horizontal and the vertical scrollbar will be enabled.</p>
</div>
<div id="section13" class="section"><h2><a name="section13">SPECIALISED PLOTS</a></h2>
<p>Most of the plot and chart types described above have a fairly general use
and you simply prepares the data to be plotted yourself. This section describes
several plot types that are more specialised, in the sense that they have specific
purposes and you pass raw data that are then processed in the plotting routines.</p>
<p>Currently there are the following types:</p>
<ul class="itemized">
<li><p>Target diagrams are used to assess the capacity of numerical models to reproduce measurement
data. They are described in detail in:</p>
<pre class="example">
Jason K. Joliff et al.
Summary diagrams for coupled hydrodynamic-ecosystem model skill assessment
Journal of Marine Systems 76 (2009) 64-82
DOI: 10.1016/j.jmarsys.2008.05.014
</pre>
</li>
<li><p>Performance profiles are used for comparing the performance of numerical methods or
implementations thereof with each other. For more information:</p>
<pre class="example">
Desmond Higham and Nicholas Higham
Matlab Guide
SIAM, 2005, Philadephia
</pre>
</li>
</ul>
<p>Most of the general methods for XY-plots work for these plots as well, but their
creation and the methods to plot the data are very specific.</p>
<dl class="definitions">
<dt><a name="130"><b class="cmd">::Plotchart::createTargetDiagram</b> <i class="arg">w</i> <i class="arg">limits</i> <i class="arg">scale</i></a></dt>
<dd><p>Create a new target diagram with circles indicating specific limits. The x-axis represents the
unbiased "root-mean-square difference" (typically varying between -1 and 1) and the y-axis
represents the normalised bias.</p>
<p>Data points closer to the origin represent better results than data points further away.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>list <i class="arg">limits</i> (in)</dt>
<dd><p>List of radii for the circles that represent the limits (for instance: 0.5 and 0.7)</p></dd>
<dt>double <i class="arg">scale</i> (in)</dt>
<dd><p>Scale for the axes - defaults to 1, but if the model results are a poor fit, then
that may be too small a value. Both axes are scaled in the same way.</p></dd>
</dl></dd>
<dt><a name="131"><b class="cmd">$target</b> plot <i class="arg">series</i> <i class="arg">xvalues</i> <i class="arg">yvalues</i></a></dt>
<dd><p>The plot method takes two series of data of the same length, the first one
representing the model results, the second one represent the measurements
or, more general, the data that need to be reproduced.</p>
<dl class="arguments">
<dt>string <i class="arg">series</i> (in)</dt>
<dd><p>Name of the series (it will be plotted as a symbol that is configured via the
<em>$target dataconfig</em> command (see the XY-plot equivalent for an explanation)</p></dd>
<dt>list <i class="arg">xvalues</i> (in)</dt>
<dd><p>List of model results (missing values are represented as empty strings)</p></dd>
<dt>list <i class="arg">yvalues</i> (in)</dt>
<dd><p>List of measured values (missing values are represented as empty strings; only if
both the x and the y values are given, is the pair used in the computations)</p></dd>
</dl></dd>
<dt><a name="132"><b class="cmd">::Plotchart::createPerformanceProfile</b> <i class="arg">w</i> <i class="arg">max</i></a></dt>
<dd><p>Create a diagram to show the performance of various numerical methods (or solvers). The idea is
to first run these methods on a set of problems and measure their performance. The smaller the
number the better. Then these methods are compared via a so-called performance profile:
the data are scaled and ordered, such that the best method ends up highest.</p>
<p>Because of the nature of the plot all data must be given at once.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>Name of the <em>existing</em> canvas widget to hold the plot.</p></dd>
<dt>float <i class="arg">max</i> (in)</dt>
<dd><p>Maximum value for the x-axis (the x-axis is the scaled performance of the series).</p></dd>
</dl></dd>
<dt><a name="133"><b class="cmd">$performance</b> plot <i class="arg">series_and_data_pairs</i></a></dt>
<dd><p>Plot the data for each given method. The data are identified by the series name and the
appearance is controlled via prior dataconfig subcommand.</p>
<dl class="arguments">
<dt>list <i class="arg">series_and_data_pairs</i> (in)</dt>
<dd><p>List of series names and data. All data must be given at once.</p></dd>
</dl></dd>
</dl>
<p>The command <i class="term">plotmethod</i> can be used to add new methods for a particular
plot or chart type. It is intended to help you develop specialised graphical displays.</p>
<dl class="definitions">
<dt><a name="134"><b class="cmd">::Plotchart::plotmethod</b> <i class="arg">charttype</i> <i class="arg">methodname</i> <i class="arg">plotproc</i></a></dt>
<dd><p>Adds a new method for the given plot or chart type. The method is implemented by the
command or procedure given in the plotproc argument. The procedure will be called with
two extra arguments, the name of the created plot and the canvas widget that contains
(see the example below).</p>
<dl class="arguments">
<dt>string <i class="arg">charttype</i> (in)</dt>
<dd><p>The type of plot or chart that the new method should be added to.</p></dd>
<dt>string <i class="arg">methodname</i> (in)</dt>
<dd><p>Name of the method to be used.</p></dd>
<dt>string <i class="arg">plotproc</i> (in)</dt>
<dd><p>Name of the command or procedure that implements the method.</p></dd>
</dl></dd>
</dl>
<p>Here is a trivial example of how to use this:</p>
<pre class="example">
#
# The custom method "doodle" always adds the text "DOODLE"
# to the plot
#
proc doodle {p w x y} {
$p plaintext $x $y "DOODLE"
}
::Plotchart::plotmethod xyplot doodle doodle
#
# Use it
pack [canvas .c]
set p [::Plotchart::createXYPlot .c {0 100 10} {0 20 5}]
$p doodle 40 10
</pre>
</div>
<div id="section14" class="section"><h2><a name="section14">TABLE CHARTS</a></h2>
<p>To show what you can do with table charts, here is a simple example that
plots a number of random data. The colours depend on the range that the
data belong to. For this the procedure <i class="term">setColor</i> is used.</p>
<pre class="example">
package require Plotchart
pack [canvas .c -bg white -height 300] -fill both -expand yes
::Plotchart::plotconfig table frame outerwidth 3
::Plotchart::plotconfig table frame color red
set t [::Plotchart::createTableChart .c {"Column 1" "Column 2" "Column 3"} 80]
proc setColor {table widget row col value} {
$table cellconfigure -background white -color black
if { $value < 2.0 } {
$table cellconfigure -background red -color white
}
if { $value > 6.0 } {
$table cellconfigure -background green
}
return [format "%6.3f" $value]
}
# Command must already exist ...
$t formatcommand setColor
$t title "Demonstration of table charts"
$t separator
for {set i 0} {$i < 9} {incr i} {
set row {}
for {set j 0} {$j < 3} {incr j} {
lappend row [expr {10.0 * rand()}]
}
if { $i == 3 } {
$t separator
}
$t row $row
}</pre>
</div>
<div id="section15" class="section"><h2><a name="section15">CONTROL DISPLAYS</a></h2>
<p>TODO</p>
</div>
<div id="section16" class="section"><h2><a name="section16">ARRANGING MULTIPLE PLOTS IN A CANVAS</a></h2>
<p>The command <i class="term">plotpack</i> allows you to copy the contents of a plot
into another canvas widget. This canvas widget does not act as a
composite plot, but it can be saved as a PostScript file for instance:
Note: the command simply takes a snapshot of the plots/charts as they
are at that moment.</p>
<dl class="definitions">
<dt><a name="135"><b class="cmd">::Plotchart::plotpack</b> <i class="arg">w</i> <i class="arg">dir</i> <i class="arg">args</i></a></dt>
<dd><p>Copy the contents of the plots/charts into another widget, in a manner
similar to the <i class="term">pack</i> geometry manager.</p>
<dl class="arguments">
<dt>widget <i class="arg">w</i> (in)</dt>
<dd><p>The name of the canvas widget to copy the plots/charts into</p></dd>
<dt>string <i class="arg">dir</i> (in)</dt>
<dd><p>The direction of the arrangement - top, left, bottom or right</p></dd>
<dt>list <i class="arg">args</i> (in)</dt>
<dd><p>List of plots/charts to be copied.</p></dd>
</dl></dd>
</dl>
<p>For example:</p>
<pre class="example">
set p1 [createXYPlot ...]
set p2 [createBarchart ...]
... fill the plots ...
toplevel .t
pack [canvas .t.c2 -width ...]
#
# Copy the two plots above each other in the new canvas
#
plotpack .t.c2 top $p1 $p2
</pre>
<p>A different method is to use the <em>-box</em> and <em>-axesbox</em> options
when creating the plot. These control the area in the canvas where the
plot or chart will be drawn.</p>
<p>The <em>-box</em> option takes as its value a list of four numbers:</p>
<ul class="itemized">
<li><p>X-coordinate of the upper-left corner of the area that will contain the
plot or chart (simply a canvas coordinate)</p></li>
<li><p>Y-coordinate of the upper-left corner</p></li>
<li><p>Width of the area</p></li>
<li><p>Height of the area</p></li>
</ul>
<p>Specifying the width and height makes it easier to reposition the area
with respect to other plots.</p>
<p>The <em>-axesbox</em> option is meant to make aligning the axes of a
plot with those of other plots easier. The option takes a list of
six arguments:</p>
<ul class="itemized">
<li><p>Identification of the plot with respect to which it should be
positioned (the command returned by the creation command).</p></li>
<li><p>The anchor position that should be used (n, nw, ...)</p></li>
<li><p>X-coordinate of the upper-left corner of the area that will contain the
plot or chart. This coordinates is taken relative to the
<em>anchor position</em></p></li>
<li><p>Y-coordinate of the upper-left corner</p></li>
<li><p>Width of the axis area</p></li>
<li><p>Height of the axis area</p></li>
</ul>
<p>With this option the area the axes occupy is first determined and the
complete area is derived from the margins.</p>
<p>For example:</p>
<pre class="example">
set p2 [::Plotchart::createXYPlot .c {0 10 1} {-5 5 2.5} -axesbox [list $p1 ne 0 0 200 200]]
</pre>
<p>will create a second plot whose left axis coincides with the right axis
of plot "\$p1" and the top of the axis is at the same heigt as well -
because the axes are positioned at a point 0 pixels to the left and 0
pixels below the north-east corner.</p>
</div>
<div id="section17" class="section"><h2><a name="section17">INTERACTIVE USE</a></h2>
<p><em>Plotchart</em> has several features for interactive use (cf. <span class="sectref"><a href="#section18">NOTES ON TAGS</a></span>):</p>
<ul class="itemized">
<li><p>The legend can be moved around by pressing mouse button 1 in the legend's box and
keeping it down.</p></li>
<li><p>You can use the <em>bindplot</em> and <em>bindlast</em> commands to
define actions that are to be taken when the user clicks on an element of the plot or chart.
(see below, see also the sample code in plotdemos12.tcl)</p></li>
<li><p><em>Piecharts</em> can show an "exploded" segment that you can select with mouse button 1.</p></li>
</ul>
<p>If you require different forms of interaction, not covered by <em>Plotchart</em> itself,
you can use the tags on the various canvas elements to define other bindings.</p>
<p>The <em>bindplot</em> and <em>bindlast</em> are defined as follows:</p>
<dl class="definitions">
<dt><a name="136"><b class="cmd">$anyplot</b> bindplot <i class="arg">event</i> <i class="arg">command</i> <i class="arg">args</i></a></dt>
<dd><p>Register a command that will be run whenever the given event occurs in the plot.</p>
<dl class="arguments">
<dt>string <i class="arg">event</i></dt>
<dd><p>The event that you want to bind the command to</p></dd>
<dt>string <i class="arg">command</i></dt>
<dd><p>Name of the command/procedure that you want to run. The following arguments
are prefixed: the x- and y-coordinates of the point in the plot (the world coordinates!),
so that the procedure has the signature:</p>
<pre class="example">
cmd $xworld $yworld $string1 $string2 $string3
</pre>
<p>assuming the argument "command" is: {cmd A B C}</p></dd>
</dl></dd>
<dt><a name="137"><b class="cmd">$anyplot</b> bindlast <i class="arg">series</i> <i class="arg">event</i> <i class="arg">command</i></a></dt>
<dd><p>Register a command that will be run when the event occurs within the neighbourhood of
the last point added to the given series. (You can use directly after inserting
a data point. All such commands will remain active).</p>
<dl class="arguments">
<dt>string <i class="arg">event</i></dt>
<dd><p>The event that you want to bind the command to</p></dd>
<dt>list <i class="arg">command</i></dt>
<dd><p>Name of the command/procedure that you want to run. The following arguments
are prefixed: the x- and y-coordinates of the point in the plot (the world coordinates!),
so that the procedure has the signature:</p>
<pre class="example">
cmd $xworld $yworld $string1 $string2 $string3
</pre>
<p>assuming the argument "command" is: {cmd A B C}</p></dd>
</dl></dd>
</dl>
<p>Here is an example - show the values of the data points in an annotation
(from the sample code in plotdemos12.tcl):</p>
<pre class="example">
#
# Procedure for showing an annotation
#
proc showAnnotation {xcoord ycoord plot w} {
$plot balloon $xcoord $ycoord "Data point: [format "%.3f, %.3f" $xcoord $ycoord]" north
after 2000 [list removeAnnotation $w]
}
#
# Procedure for erase an annotation
#
proc removeAnnotation {w} {
# Use the tags to remove all annotations
$w delete BalloonText
$w delete BalloonFrame
}
#
# Create a simple plot and a label
#
pack [canvas .c -bg white] [label .l -textvariable coords]
set p [::Plotchart::createXYPlot .c {0 1000 200} {0 10 1}]
$p dataconfig series1 -type both -symbol cross
foreach x {1 2 5 10 20 50 100 200 500 1000} {
$p plot series1 $x [expr {log($x)}]
#
# Show the annotation for each data point
#
$p bindlast series1 <Enter> [list showAnnotation $p %W]
}
</pre>
</div>
<div id="section18" class="section"><h2><a name="section18">NOTES ON TAGS</a></h2>
<p>The implementation of <em>Plotchart</em> relies heavily on the canvas's
ability to identify graphical objects by tags and to change the drawing order of
the objects. This section documents the tags that are used.</p>
<p>(<em>Note:</em> the tags are not always used consistently - see the notes appearing with
the various tags. This section describes the current state.)</p>
<p><em>General graphical objects:</em></p>
<ul class="itemized">
<li><p><em>mask</em> - Used to manipulate the opaque rectangles that ensure data outside
the viewport are not shown.</p></li>
<li><p><em>topmask, horizmask, vertmask</em> - specialised tags, used for scrollable plots.</p></li>
<li><p><em>title</em> - Used for title strings.</p></li>
<li><p><em>BalloonText, BalloonFrame</em> - Used to manipulate balloon text.</p></li>
<li><p><em>PlainText</em> - Used to manipulate ordinary text without any decoration.</p></li>
<li><p><em>background</em> - Tag used for gradient and image backgrounds (and for gradient-filled bars).</p></li>
<li><p><em>xaxis, yaxis</em> - Tags used for all objects related to horizontal or vertical axes.
(also: both for numerical axes and axes with labels as in barcharts).
Note, however, that the <em>text</em> along the axes has no particular tag.</p></li>
<li><p><em>raxis</em> - Tag used for all objects related to a <em>right</em> axis.</p></li>
<li><p><em>taxis</em> - Tag used for all objects related to a <em>time</em> axis.</p></li>
<li><p><em>axis3d</em> - Tag used for 3D axes</p></li>
<li><p><em>xtickline, ytickline</em> - Tags used for ticklines.</p></li>
<li><p><em>legend, legengb, legendobj</em> - Tags used for the legend. The latter is used to manipulate
the legend as a whole.</p></li>
<li><p><em>legend_series</em> - Tag used to control the appearance of the legend entry ("series" should
be replaced by the series name).</p></li>
<li><p><em>object</em> - used as standard tag for all objects drawn with the <b class="cmd">::Plotchart::drawobject</b>
procedure. Tags given at object creation time are added to this tag.</p></li>
</ul>
<p><em>XY-plots (all types of axes):</em></p>
<ul class="itemized">
<li><p><em>data</em> - The general tag to identify graphical objects associated with data.
<em>data_seriesname</em> - The tag specific to a data series ("seriesname" should be replaced).
<em>band</em> - The horizontal or vertical band drawn with the xband otr yband subcommands have this tag
by the actual name).
<em>xtext</em> - The text labelling the xaxis.
<em>ytext</em> - The text labelling hte yaxis horizontically.
<em>vtext</em> - The text labelling the yaxis vertically.</p></li>
</ul>
<p>Items such as labelled dots only have the "data" tag.</p>
<p><em>Piecharts and spiral pies:</em></p>
<ul class="itemized">
<li><p><em>segment_segmentnumber</em> - The tag identifying the segment, the string "segmentnumber" should
be replaced by the actual number. This tag is used to explode the segments.</p></li>
</ul>
<p><em>Barcharts:</em></p>
<p>Barcharts use the same tags as xy-plots (but for gradient-filled bars the data_seriesname is not used).</p>
<p><em>Histograms and isometric plots:</em></p>
<p>Currently the only tag used is "data".</p>
<p><em>Time-charts:</em></p>
<p>As these plots are scrollable, several tags are used specific to the scrolling:
vertscroll, horizscroll, below, lowest, above, timeline, tline.
Each item also has a tag of the form "item_number",
where "number" is to be replaced by the actual sequence number of the item.</p>
<p><em>Gantt charts:</em></p>
<p>In addition to the tags described for the time-charts, the following tags are used:
description, completed, summary and summarybar.</p>
<p><em>Radial charts and polar plots:</em></p>
<p>Currently the radial lines indicating the grid have no tags. The graphical objects associated with
data only have the "data" tag.</p>
<p><em>Windroses:</em></p>
<p>Only the tag <em>data_number</em> is currently used ("number" should be replaced by the
sequence number of the data, starting at 0.</p>
<p><em>Contour and isoline plots:</em></p>
<p>No tags are used.</p>
<p><em>3D plots and 3D ribbon plots:</em></p>
<p>No tags are used for the data objects, only for the axes.</p>
<p><em>Charts decorated with 3D effects:</em></p>
<p>The following tags are used to identify various types of graphical objects: platform, background, d, u,
ticklines.</p>
<p>The text associated with the bars has no tags. The ribbon lines and areas have no tags either.</p>
<p><em>Tables:</em></p>
<p>Tags used are: frame, cellbg and celltext
<em>In addition:</em>
To implement multiple plots and charts in a single canvas, all items
also get as a tag the plot/chart they belong to. This enables Plotchart
to manipulate only those items.</p>
</div>
<div id="section19" class="section"><h2><a name="section19">TODO - SOME PRIVATE NOTES</a></h2>
<p>I have the following wishlist:</p>
<ul class="itemized">
<li><p>Isometric plots - allow new items to be implemented easily.</p></li>
<li><p>A general 3D viewer - emphasis on geometry, not a ray-tracer.</p></li>
<li><p>Several improvements for boxplots:</p>
<ul class="itemized">
<li><p>Height of the box scales with the logarithm of the number of points</p></li>
<li><p>Marker line to indicate a "current" value</p></li>
<li><p>Box drawn from quantiles</p></li>
</ul>
</li>
</ul>
</div>
<div id="keywords" class="section"><h2><a name="keywords">Keywords</a></h2>
<p>3D bars, 3D surfaces, bar charts, charts, coordinate transformations, coordinates, graphical presentation, isometric plots, pie charts, plotting, polar plots, strip charts, tables, time charts, xy-plots</p>
</div>
<div id="copyright" class="section"><h2><a name="copyright">Copyright</a></h2>
<p>Copyright © 2011 Arjen Markus <arjenmarkus@users.sourceforge.net></p>
</div>
</div></body></html>
|