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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="pandoc" />
<title>wxMaxima</title>
<style type="text/css">
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
pre > code.sourceCode { white-space: pre; position: relative; }
pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
pre > code.sourceCode > span:empty { height: 1.2em; }
code.sourceCode > span { color: inherit; text-decoration: inherit; }
div.sourceCode { margin: 1em 0; }
pre.sourceCode { margin: 0; }
@media screen {
div.sourceCode { overflow: auto; }
}
@media print {
pre > code.sourceCode { white-space: pre-wrap; }
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
}
pre.numberSource code
{ counter-reset: source-line 0; }
pre.numberSource code > span
{ position: relative; left: -4em; counter-increment: source-line; }
pre.numberSource code > span > a:first-child::before
{ content: counter(source-line);
position: relative; left: -1em; text-align: right; vertical-align: baseline;
border: none; display: inline-block;
-webkit-touch-callout: none; -webkit-user-select: none;
-khtml-user-select: none; -moz-user-select: none;
-ms-user-select: none; user-select: none;
padding: 0 4px; width: 4em;
color: #aaaaaa;
}
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
div.sourceCode
{ }
@media screen {
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
}
code span.al { color: #ff0000; font-weight: bold; } /* Alert */
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
code span.at { color: #7d9029; } /* Attribute */
code span.bn { color: #40a070; } /* BaseN */
code span.bu { } /* BuiltIn */
code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
code span.ch { color: #4070a0; } /* Char */
code span.cn { color: #880000; } /* Constant */
code span.co { color: #60a0b0; font-style: italic; } /* Comment */
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
code span.do { color: #ba2121; font-style: italic; } /* Documentation */
code span.dt { color: #902000; } /* DataType */
code span.dv { color: #40a070; } /* DecVal */
code span.er { color: #ff0000; font-weight: bold; } /* Error */
code span.ex { } /* Extension */
code span.fl { color: #40a070; } /* Float */
code span.fu { color: #06287e; } /* Function */
code span.im { } /* Import */
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
code span.kw { color: #007020; font-weight: bold; } /* Keyword */
code span.op { color: #666666; } /* Operator */
code span.ot { color: #007020; } /* Other */
code span.pp { color: #bc7a00; } /* Preprocessor */
code span.sc { color: #4070a0; } /* SpecialChar */
code span.ss { color: #bb6688; } /* SpecialString */
code span.st { color: #4070a0; } /* String */
code span.va { color: #19177c; } /* Variable */
code span.vs { color: #4070a0; } /* VerbatimString */
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
</style>
<link rel="stylesheet" href="wxmaxima.css" type="text/css" />
<link rel="icon" type="image/svg+xml" href="wxmaxima.svg" />
</head>
<body>
<div id="header">
<h1 class="title">wxMaxima</h1>
</div>
<div id="TOC">
<ul>
<li><a href="#the-wxmaxima-user-manual">The wxMaxima user manual</a></li>
<li><a href="#introduction-to-wxmaxima"><span class="toc-section-number">1</span> Introduction to wxMaxima</a>
<ul>
<li><a href="#maxima-and-wxmaxima"><span class="toc-section-number">1.1</span> <em>Maxima</em> and wxMaxima</a>
<ul>
<li><a href="#maxima"><span class="toc-section-number">1.1.1</span> <em>Maxima</em></a></li>
<li><a href="#wxmaxima"><span class="toc-section-number">1.1.2</span> wxMaxima</a></li>
</ul></li>
<li><a href="#workbook-basics"><span class="toc-section-number">1.2</span> Workbook basics</a>
<ul>
<li><a href="#the-workbook-approach"><span class="toc-section-number">1.2.1</span> The workbook approach</a></li>
<li><a href="#cells"><span class="toc-section-number">1.2.2</span> Cells</a></li>
<li><a href="#horizontal-and-vertical-cursors"><span class="toc-section-number">1.2.3</span> Horizontal and vertical cursors</a></li>
<li><a href="#sending-cells-to-maxima"><span class="toc-section-number">1.2.4</span> Sending cells to Maxima</a></li>
<li><a href="#command-autocompletion"><span class="toc-section-number">1.2.5</span> Command autocompletion</a></li>
<li><a href="#side-panes"><span class="toc-section-number">1.2.6</span> Side Panes</a></li>
<li><a href="#mathml-output"><span class="toc-section-number">1.2.7</span> MathML output</a></li>
<li><a href="#markdown-support"><span class="toc-section-number">1.2.8</span> Markdown support</a></li>
<li><a href="#hotkeys"><span class="toc-section-number">1.2.9</span> Hotkeys</a></li>
<li><a href="#raw-tex-in-the-tex-export"><span class="toc-section-number">1.2.10</span> Raw TeX in the TeX export</a></li>
</ul></li>
<li><a href="#file-formats"><span class="toc-section-number">1.3</span> File Formats</a>
<ul>
<li><a href="#mac"><span class="toc-section-number">1.3.1</span> .mac</a></li>
<li><a href="#wxm"><span class="toc-section-number">1.3.2</span> .wxm</a></li>
<li><a href="#wxmx"><span class="toc-section-number">1.3.3</span> .wxmx</a></li>
</ul></li>
<li><a href="#configuration-options"><span class="toc-section-number">1.4</span> Configuration options</a>
<ul>
<li><a href="#default-animation-framerate"><span class="toc-section-number">1.4.1</span> Default animation framerate</a></li>
<li><a href="#default-plot-size-for-new-maxima-sessions"><span class="toc-section-number">1.4.2</span> Default plot size for new <em>maxima</em> sessions</a></li>
<li><a href="#match-parenthesis-in-text-controls"><span class="toc-section-number">1.4.3</span> Match parenthesis in text controls</a></li>
<li><a href="#dont-save-the-worksheet-automatically"><span class="toc-section-number">1.4.4</span> Don’t save the worksheet automatically</a></li>
<li><a href="#where-is-the-configuration-saved"><span class="toc-section-number">1.4.5</span> Where is the configuration saved?</a></li>
</ul></li>
</ul></li>
<li><a href="#extensions-to-maxima"><span class="toc-section-number">2</span> Extensions to <em>Maxima</em></a>
<ul>
<li><a href="#subscripted-variables"><span class="toc-section-number">2.1</span> Subscripted variables</a></li>
<li><a href="#user-feedback-in-the-status-bar"><span class="toc-section-number">2.2</span> User feedback in the status bar</a></li>
<li><a href="#plotting"><span class="toc-section-number">2.3</span> Plotting</a>
<ul>
<li><a href="#embedding-a-plot-into-the-work-sheet"><span class="toc-section-number">2.3.1</span> Embedding a plot into the work sheet</a></li>
<li><a href="#making-embedded-plots-bigger-or-smaller"><span class="toc-section-number">2.3.2</span> Making embedded plots bigger or smaller</a></li>
<li><a href="#better-quality-plots"><span class="toc-section-number">2.3.3</span> Better quality plots</a></li>
<li><a href="#opening-embedded-plots-in-interactive-gnuplot-windows"><span class="toc-section-number">2.3.4</span> Opening embedded plots in interactive <em>gnuplot</em> windows</a></li>
<li><a href="#opening-gnuplots-command-console-in-plot-windows"><span class="toc-section-number">2.3.5</span> Opening gnuplot’s command console in <code>plot</code> windows</a></li>
<li><a href="#embedding-animations-into-the-spreadsheet"><span class="toc-section-number">2.3.6</span> Embedding animations into the spreadsheet</a></li>
<li><a href="#opening-multiple-plots-in-contemporaneous-windows"><span class="toc-section-number">2.3.7</span> Opening multiple plots in contemporaneous windows</a></li>
<li><a href="#the-plot-using-draw-side-pane"><span class="toc-section-number">2.3.8</span> The “Plot using draw” side pane</a></li>
</ul></li>
<li><a href="#embedding-graphics"><span class="toc-section-number">2.4</span> Embedding graphics</a></li>
<li><a href="#startup-files"><span class="toc-section-number">2.5</span> Startup files</a></li>
<li><a href="#special-variables-wx"><span class="toc-section-number">2.6</span> Special variables wx…</a></li>
<li><a href="#pretty-printing-2d-output"><span class="toc-section-number">2.7</span> Pretty-printing 2D output</a></li>
<li><a href="#bug-reporting"><span class="toc-section-number">2.8</span> Bug reporting</a></li>
<li><a href="#marking-output-being-drawn-in-red"><span class="toc-section-number">2.9</span> Marking output being drawn in red</a></li>
</ul></li>
<li><a href="#troubleshooting"><span class="toc-section-number">3</span> Troubleshooting</a>
<ul>
<li><a href="#cannot-connect-to-maxima"><span class="toc-section-number">3.1</span> Cannot connect to <em>Maxima</em></a></li>
<li><a href="#how-to-save-data-from-a-broken-.wxmx-file"><span class="toc-section-number">3.2</span> How to save data from a broken .wxmx file</a></li>
<li><a href="#i-want-some-debug-info-to-be-displayed-on-the-screen-before-my-command-has-finished"><span class="toc-section-number">3.3</span> I want some debug info to be displayed on the screen before my command has finished</a></li>
<li><a href="#plotting-only-shows-a-closed-empty-envelope-with-an-error-message"><span class="toc-section-number">3.4</span> Plotting only shows a closed empty envelope with an error message</a></li>
<li><a href="#plotting-an-animation-results-in-error-undefined-variable"><span class="toc-section-number">3.5</span> Plotting an animation results in “error: undefined variable”</a></li>
<li><a href="#i-lost-a-cell-contents-and-undo-doesnt-remember"><span class="toc-section-number">3.6</span> I lost a cell contents and undo doesn’t remember</a></li>
<li><a href="#wxmaxima-starts-up-with-the-message-maxima-process-terminated."><span class="toc-section-number">3.7</span> <em>wxMaxima</em> starts up with the message “Maxima process terminated.”</a></li>
<li><a href="#maxima-is-forever-calculating-and-not-responding-to-input"><span class="toc-section-number">3.8</span> Maxima is forever calculating and not responding to input</a></li>
<li><a href="#my-sbcl-based-maxima-runs-out-of-memory"><span class="toc-section-number">3.9</span> My SBCL-based <em>Maxima</em> runs out of memory</a></li>
<li><a href="#input-sometimes-is-sluggishignoring-keys-on-ubuntu"><span class="toc-section-number">3.10</span> Input sometimes is sluggish/ignoring keys on Ubuntu</a></li>
<li><a href="#wxmaxima-halts-when-maxima-processes-greek-characters-or-umlauts"><span class="toc-section-number">3.11</span> <em>wxMaxima</em> halts when <em>Maxima</em> processes Greek characters or Umlauts</a></li>
<li><a href="#plotting-1"><span class="toc-section-number">3.12</span> Plotting</a>
<ul>
<li><a href="#can-i-make-wxmaxima-output-both-image-files-and-embedded-plots-at-once"><span class="toc-section-number">3.12.1</span> Can I make <em>wxMaxima</em> output both image files and embedded plots at once?</a></li>
<li><a href="#can-i-set-the-aspect-ratio-of-a-plot"><span class="toc-section-number">3.12.2</span> Can I set the aspect ratio of a plot?</a></li>
</ul></li>
</ul></li>
<li><a href="#faq"><span class="toc-section-number">4</span> FAQ</a>
<ul>
<li><a href="#is-there-a-way-to-make-more-text-fit-on-a-latex-page"><span class="toc-section-number">4.1</span> Is there a way to make more text fit on a LaTeX page?</a></li>
<li><a href="#is-there-a-dark-mode"><span class="toc-section-number">4.2</span> Is there a dark mode?</a></li>
<li><a href="#wxmaxima-sometimes-hangs-for-a-several-seconds-once-in-the-first-minute"><span class="toc-section-number">4.3</span> <em>wxMaxima</em> sometimes hangs for a several seconds once in the first minute</a></li>
</ul></li>
<li><a href="#command-line-arguments"><span class="toc-section-number">5</span> Command-line arguments</a></li>
</ul>
</div>
<h1 class="unnumbered" number="" id="the-wxmaxima-user-manual">The wxMaxima user manual</h1>
<p>wxMaxima is a graphical user interface (GUI) for the <em>Maxima</em> computer algebra system (CAS). wxMaxima allows one to use all of <em>Maxima</em>’s functions. In addition, it provides convenient wizards for accessing the most commonly used features. This manual describes some of the features that make wxMaxima one of the most popular GUIs for <em>Maxima</em>.</p>
<div class="figure">
<img src="./wxMaximaLogo.png" id="img_wxMaximaLogo" alt="" />
<p class="caption">wxMaxima logo</p>
</div>
<p>Before we look at the content a few points regarding navigation are in order. Immediately below is a short table of contents. Clicking on any of the listed items moves the cursor to the top of the indicated section of the manual. Clicking on <a href="#TOC">Contents</a> moves the cursor to an extended table of contents. This extended table can be used to navigate more directly to specific parts of the manual. The Contents link appears at locations throughout the text for navigational purposes.</p>
<ul>
<li><a href="#introduction-to-wxmaxima" title="Introduction to wxMaxima">Introduction</a>:</li>
</ul>
<p>wxMaxima basics</p>
<ul>
<li><a href="#extensions-to-maxima" title="Extensions">Extensions</a>:</li>
</ul>
<p>The commands wxMaxima adds to <em>Maxima</em></p>
<ul>
<li><a href="#troubleshooting" title="Troubleshooting">Troubleshooting</a>:</li>
</ul>
<p>What to do if wxMaxima does not work as expected</p>
<ul>
<li><a href="#faq" title="FAQ">FAQ</a>:</li>
</ul>
<p>Frequently asked questions</p>
<ul>
<li><a href="#command-line-arguments" title="_Maxima_ Command Line">CommandLine</a>:</li>
</ul>
<p>The command-line arguments wxMaxima supports</p>
<hr />
<h1 number="1" id="introduction-to-wxmaxima"><span class="header-section-number">1</span> Introduction to wxMaxima</h1>
<h2 number="1.1" id="maxima-and-wxmaxima"><span class="header-section-number">1.1</span> <em>Maxima</em> and wxMaxima</h2>
<p>In the open-source domain, big systems are normally split into smaller projects that are easier to handle for small groups of developers. For example a CD burner program will consist of a command-line tool that actually burns the CD and a graphical user interface that allows users to implement it without having to learn about all the command line switches and in fact without using the command line at all. One advantage of this approach is that the developing work that was invested into the command-line program can be shared by many programs: The same CD-burner command-line program can be used as a “send-to-CD”-plug-in for a file manager application, for the “burn to CD” function of a music player and as the CD writer for a DVD backup tool. Another advantage is that splitting one big task into smaller parts allows the developers to provide several user interfaces for the same program.</p>
<p>A computer algebra system (CAS) like <em>Maxima</em> fits into this framework. A CAS can provide the logic behind an arbitrary precision calculator application or it can do automatic transforms of formulas in the background of a bigger system (e.g., <a href="https://www.sagemath.org/">Sage</a>). Alternatively, it can be used directly as a free-standing system. <em>Maxima</em> can be accessed via a command line. Often, however, an interface like <em>wxMaxima</em> proves a more efficient way to access the software, especially for newcomers.</p>
<h3 number="1.1.1" id="maxima"><span class="header-section-number">1.1.1</span> <em>Maxima</em></h3>
<p><em>Maxima</em> is a full-featured computer algebra system (CAS). A CAS is a program that can solve mathematical problems by rearranging formulas and finding a formula that solves the problem as opposed to just outputting the numeric value of the result. In other words, <em>Maxima</em> can serve as a calculator that gives numerical representations of variables, and it can also provide analytical solutions. Furthermore, it offers a range of numerical methods of analysis for equations or systems of equations that cannot be solved analytically.</p>
<div class="figure">
<img src="./maxima_screenshot.png" id="img_maxima_screenshot" alt="" />
<p class="caption">Maxima screenshot, command line</p>
</div>
<p>Extensive documentation for <em>Maxima</em> is <a href="http://maxima.sourceforge.net/documentation.html">available in the internet</a>. Part of this documentation is also available in wxMaxima’s help menu. Pressing the Help key (on most systems the F1 key) causes <em>wxMaxima</em>’s context-sensitive help feature to automatically jump to <em>Maxima</em>’s manual page for the command at the cursor.</p>
<h3 number="1.1.2" id="wxmaxima"><span class="header-section-number">1.1.2</span> wxMaxima</h3>
<p><em>wxMaxima</em> is a graphical user interface that provides the full functionality and flexibility of <em>Maxima</em>. wxMaxima offers users a graphical display and many features that make working with <em>Maxima</em> easier. For example <em>wxMaxima</em> allows one to export any cell’s contents (or, if that is needed, any part of a formula, as well) as text, as LaTeX or as MathML specification at a simple right-click. Indeed, an entire workbook can be exported, either as a HTML file or as a LaTeX file. Documentation for <em>wxMaxima</em>, including workbooks to illustrate aspects of its use, is online at the <em>wxMaxima</em> <a href="https://wxMaxima-developers.github.io/wxmaxima/help.html">help site</a>, as well as via the help menu.</p>
<div class="figure">
<img src="./wxMaximaWindow.png" id="img_wxMaximaWindow" alt="" />
<p class="caption">wxMaxima window</p>
</div>
<p>The calculations that are entered in <em>wxMaxima</em> are performed by the <em>Maxima</em> command-line tool in the background.</p>
<h2 number="1.2" id="workbook-basics"><span class="header-section-number">1.2</span> Workbook basics</h2>
<p>Much of <em>wxMaxima</em> is self-explaining, but some details require attention. <a href="https://wxMaxima-developers.github.io/wxmaxima/help.html">This site</a> contains a number of workbooks that address various aspects of <em>wxMaxima</em>. Working through some of these (particularly the “10 minute <em>(wx)Maxima</em> tutorial”) will increase one’s familiarity with both the content of <em>Maxima</em> and the use of <em>wxMaxima</em> to interact with <em>Maxima</em>. This manual concentrates on describing aspects of <em>wxMaxima</em> that are not likely to be self-evident and that might not be covered in the online material.</p>
<h3 number="1.2.1" id="the-workbook-approach"><span class="header-section-number">1.2.1</span> The workbook approach</h3>
<p>One of the very few things that are not standard in <em>wxMaxima</em> is that it organizes the data for <em>Maxima</em> into cells that are evaluated (which means: sent to <em>Maxima</em>) only when the user requests this. When a cell is evaluated, all commands in that cell, and only that cell, are evaluated as a batch. (The preceding statement is not quite accurate: One can select a set of adjacent cells and evaluate them together. Also, one can instruct <em>Maxima</em> to evaluate all cells in a workbook in one pass.) <em>wxMaxima</em>’s approach to submitting commands for execution might feel unfamiliar at the first sight. It does, however, drastically ease work with big documents (where the user does not want every change to automatically trigger a full re-evaluation of the whole document). Also, this approach is very handy for debugging.</p>
<p>If text is typed into <em>wxMaxima</em> it automatically creates a new worksheet cell. The type of this cell can be selected in the toolbar. If a code cell is created the cell can be sent to <em>Maxima</em>, which causes the result of the calculation to be displayed below the code. A pair of such commands is shown below.</p>
<div class="figure">
<img src="./InputCell.png" id="img_InputCell" alt="" />
<p class="caption">Input/output cell</p>
</div>
<p>On evaluation of an input cell’s contents the input cell <em>Maxima</em> assigns a label to the input (by default shown in red and recognizable by the <code>%i</code>) by which it can be referenced later in the <em>wxMaxima</em> session. The output that <em>Maxima</em> generates also gets a label that begins with <code>%o</code> and by default is hidden, except if the user assigns the output a name. In this case by default the user-defined label is displayed. The <code>%o</code>-style label <em>Maxima</em> auto-generates will also be accessible, though.</p>
<p>Besides the input cells <em>wxMaxima</em> allows for text cells for documentation, image cells, title cells, chapter cells and section cells. Every cell has its own undo buffer so debugging by changing the values of several cells and then gradually reverting the unneeded changes is rather easy. Furthermore the worksheet itself has a global undo buffer that can undo cell edits, adds and deletes.</p>
<p>The figure below shows different cell types (title cells, section cells, subsection cells, text cells, input/output cells and image cells).</p>
<div class="figure">
<img src="./cell-example.png" id="img_cell-example" alt="" />
<p class="caption">Example of different wxMaxima cells</p>
</div>
<h3 number="1.2.2" id="cells"><span class="header-section-number">1.2.2</span> Cells</h3>
<p>The worksheet is organized in cells. Each cell can contain other cells or the following types of content:</p>
<ul>
<li>one or more lines of <em>Maxima</em> input</li>
<li>one or more image</li>
<li>output of, or a question from, <em>Maxima</em></li>
<li>a text block that can for example be used for documentation</li>
<li>a title, section or a subsection.</li>
</ul>
<p>The default behavior of <em>wxMaxima</em> when text is entered is to automatically create a math cell. Cells of other types can be created using the Cell menu, using the hot keys shown in the menu or using the drop-down list in the toolbar. Once the non-math cell is created, whatever is typed into the file is interpreted as text.</p>
<p>Additional comment text can be entered into a math cell if bracketed as follows: <code>/*This comment will not be sent to Maxima for evaluation*/</code>.</p>
<h3 number="1.2.3" id="horizontal-and-vertical-cursors"><span class="header-section-number">1.2.3</span> Horizontal and vertical cursors</h3>
<p>If the user tries to select a complete sentence a word processor will try to extend the selection to automatically begin and end with a word boundary. Likewise <em>wxMaxima</em> if more than one cell is selected will extend the selection to whole cells.</p>
<p>What isn’t standard is that <em>wxMaxima</em> provides drag-and-drop flexibility by defining two types of cursors. <em>wxMaxima</em> will switch between them automatically when needed:</p>
<ul>
<li>The cursor is drawn horizontally if it is moved in the space between two cells or by clicking there.</li>
<li>A vertical cursor that works inside a cell. This cursor is activated by moving the cursor inside a cell using the mouse pointer or the cursor keys and works much like the cursor in a text editor.</li>
</ul>
<h3 number="1.2.4" id="sending-cells-to-maxima"><span class="header-section-number">1.2.4</span> Sending cells to Maxima</h3>
<p>The command in a code cell are executed once <kbd>CTRL</kbd>+<kbd>ENTER</kbd>, <kbd>SHIFT</kbd>+<kbd>ENTER</kbd> or the <kbd>ENTER</kbd> key on the keypad is pressed. The <em>wxMaxima</em> default is to enter commands when either <kbd>CTRL+ENTER</kbd> or <kbd>SHIFT+ENTER</kbd> is entered, but <em>wxMaxima</em> can be configured to execute commands in response to <kbd>ENTER</kbd>.</p>
<h3 number="1.2.5" id="command-autocompletion"><span class="header-section-number">1.2.5</span> Command autocompletion</h3>
<p><em>wxMaxima</em> contains an autocompletion feature that is triggered via the menu (Cell/Complete Word) or alternatively by pressing the key combination <kbd>CTRL</kbd>+<kbd>SPACE</kbd>. The autocompletion is context-sensitive. For example if activated within an unit specification for ezUnits it will offer a list of applicable units.</p>
<div class="figure">
<img src="./ezUnits.png" id="img_ezUnits" alt="" />
<p class="caption">ezUnits</p>
</div>
<p>Besides completing a file name, a unit name or the current command’s or variable’s name the autocompletion is able to show a template for most of the commands indicating the type (and meaning) of the parameters this program expects. To activate this feature press <kbd>SHIFT</kbd>+<kbd>CTRL</kbd>+<kbd>SPACE</kbd> or select the respective menu item (Cell/Show Template).</p>
<h4 number="1.2.5.1" id="greek-characters"><span class="header-section-number">1.2.5.1</span> Greek characters</h4>
<p>Computers traditionally stored characters in 8-bit values. This allows for a maximum of 256 different characters. All letters, numbers, and control symbols (end of transmission, end of string, lines and edges for drawing rectangles for menus <em>etc</em>.) of nearly any given language can fit within that limit.</p>
<p>For most countries the codepage of 256 characters that has been chosen does not include things like Greek letters, though, that are frequently used in mathematics. To overcome this type of limitation <a href="https://home.unicode.org/">Unicode</a> has been invented: An encoding that makes English text work like normal, but to use much more than 256 characters.</p>
<p><em>Maxima</em> allows Unicode, if it was compiled using a Lisp compiler that either supports Unicode or that doesn’t care about the font encoding. As at least one of this pair of conditions is likely to be true. <em>wxMaxima</em> provides a method of entering Greek characters using the keyboard:</p>
<ul>
<li>A Greek letter can be entered by pressing the <kbd>ESC</kbd> key and then starting to type the Greek character’s name.</li>
<li>Alternatively it can be entered by pressing <kbd>ESC</kbd>, one letter (or two for the Greek letter omicron) and <kbd>ESC</kbd> again. In this case the following letters are supported:</li>
</ul>
<table>
<thead>
<tr class="header">
<th align="center">key</th>
<th align="center">Greek letter</th>
<th align="center">key</th>
<th align="center">Greek letter</th>
<th align="center">key</th>
<th align="center">Greek letter</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td align="center">a</td>
<td align="center">alpha</td>
<td align="center">i</td>
<td align="center">iota</td>
<td align="center">r</td>
<td align="center">rho</td>
</tr>
<tr class="even">
<td align="center">b</td>
<td align="center">beta</td>
<td align="center">k</td>
<td align="center">kappa</td>
<td align="center">s</td>
<td align="center">sigma</td>
</tr>
<tr class="odd">
<td align="center">g</td>
<td align="center">gamma</td>
<td align="center">l</td>
<td align="center">lambda</td>
<td align="center">t</td>
<td align="center">tau</td>
</tr>
<tr class="even">
<td align="center">d</td>
<td align="center">delta</td>
<td align="center">m</td>
<td align="center">mu</td>
<td align="center">u</td>
<td align="center">upsilon</td>
</tr>
<tr class="odd">
<td align="center">e</td>
<td align="center">epsilon</td>
<td align="center">n</td>
<td align="center">nu</td>
<td align="center">f</td>
<td align="center">phi</td>
</tr>
<tr class="even">
<td align="center">z</td>
<td align="center">zeta</td>
<td align="center">x</td>
<td align="center">xi</td>
<td align="center">c</td>
<td align="center">chi</td>
</tr>
<tr class="odd">
<td align="center">h</td>
<td align="center">eta</td>
<td align="center">om</td>
<td align="center">omicron</td>
<td align="center">y</td>
<td align="center">psi</td>
</tr>
<tr class="even">
<td align="center">q</td>
<td align="center">theta</td>
<td align="center">p</td>
<td align="center">pi</td>
<td align="center">o</td>
<td align="center">omega</td>
</tr>
<tr class="odd">
<td align="center">A</td>
<td align="center">Alpha</td>
<td align="center">I</td>
<td align="center">Iota</td>
<td align="center">R</td>
<td align="center">Rho</td>
</tr>
<tr class="even">
<td align="center">B</td>
<td align="center">Beta</td>
<td align="center">K</td>
<td align="center">Kappa</td>
<td align="center">S</td>
<td align="center">Sigma</td>
</tr>
<tr class="odd">
<td align="center">G</td>
<td align="center">Gamma</td>
<td align="center">L</td>
<td align="center">Lambda</td>
<td align="center">T</td>
<td align="center">Tau</td>
</tr>
<tr class="even">
<td align="center">D</td>
<td align="center">Delta</td>
<td align="center">M</td>
<td align="center">Mu</td>
<td align="center">U</td>
<td align="center">Upsilon</td>
</tr>
<tr class="odd">
<td align="center">E</td>
<td align="center">Epsilon</td>
<td align="center">N</td>
<td align="center">Nu</td>
<td align="center">P</td>
<td align="center">Phi</td>
</tr>
<tr class="even">
<td align="center">Z</td>
<td align="center">Zeta</td>
<td align="center">X</td>
<td align="center">Xi</td>
<td align="center">C</td>
<td align="center">Chi</td>
</tr>
<tr class="odd">
<td align="center">H</td>
<td align="center">Eta</td>
<td align="center">Om</td>
<td align="center">Omicron</td>
<td align="center">Y</td>
<td align="center">Psi</td>
</tr>
<tr class="even">
<td align="center">T</td>
<td align="center">Theta</td>
<td align="center">P</td>
<td align="center">Pi</td>
<td align="center">O</td>
<td align="center">Omega</td>
</tr>
</tbody>
</table>
<p>The same mechanism also allows to enter some miscellaneous mathematical symbols:</p>
<table>
<thead>
<tr class="header">
<th>keys to enter</th>
<th>mathematical symbol</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td>hbar</td>
<td>Planck’s constant: a h with a horizontal bar above it</td>
</tr>
<tr class="even">
<td>Hbar</td>
<td>a H with a horizontal bar above it</td>
</tr>
<tr class="odd">
<td>2</td>
<td>squared</td>
</tr>
<tr class="even">
<td>3</td>
<td>to the power of three</td>
</tr>
<tr class="odd">
<td>/2</td>
<td>1/2</td>
</tr>
<tr class="even">
<td>partial</td>
<td>partial sign (the d of dx/dt)</td>
</tr>
<tr class="odd">
<td>integral</td>
<td>integral sign</td>
</tr>
<tr class="even">
<td>sq</td>
<td>root</td>
</tr>
<tr class="odd">
<td>ii</td>
<td>imaginary</td>
</tr>
<tr class="even">
<td>ee</td>
<td>element</td>
</tr>
<tr class="odd">
<td>in</td>
<td>in</td>
</tr>
<tr class="even">
<td>impl implies</td>
<td>implies</td>
</tr>
<tr class="odd">
<td>inf</td>
<td>infinity</td>
</tr>
<tr class="even">
<td>empty</td>
<td>empty</td>
</tr>
<tr class="odd">
<td>TB</td>
<td>Big triangle right</td>
</tr>
<tr class="even">
<td>tb</td>
<td>small triangle right</td>
</tr>
<tr class="odd">
<td>and</td>
<td>and</td>
</tr>
<tr class="even">
<td>or</td>
<td>or</td>
</tr>
<tr class="odd">
<td>xor</td>
<td>xor</td>
</tr>
<tr class="even">
<td>nand</td>
<td>nand</td>
</tr>
<tr class="odd">
<td>nor</td>
<td>nor</td>
</tr>
<tr class="even">
<td>equiv</td>
<td>equivalent</td>
</tr>
<tr class="odd">
<td>not</td>
<td>not</td>
</tr>
<tr class="even">
<td>union</td>
<td>union</td>
</tr>
<tr class="odd">
<td>inter</td>
<td>intersection</td>
</tr>
<tr class="even">
<td>subseteq</td>
<td>subset or equal</td>
</tr>
<tr class="odd">
<td>subset</td>
<td>subset</td>
</tr>
<tr class="even">
<td>notsubseteq</td>
<td>not subset or equal</td>
</tr>
<tr class="odd">
<td>notsubset</td>
<td>not subset</td>
</tr>
<tr class="even">
<td>approx</td>
<td>approximately</td>
</tr>
<tr class="odd">
<td>propto</td>
<td>proportional to</td>
</tr>
<tr class="even">
<td>neq != /= or #</td>
<td>not equal to</td>
</tr>
<tr class="odd">
<td>+/- or pm</td>
<td>a plus/minus sign</td>
</tr>
<tr class="even">
<td><= or leq</td>
<td>equal or less than</td>
</tr>
<tr class="odd">
<td>>= or geq</td>
<td>equal or greater than</td>
</tr>
<tr class="even">
<td><< or ll</td>
<td>much less than</td>
</tr>
<tr class="odd">
<td>>> or gg</td>
<td>much greater than</td>
</tr>
<tr class="even">
<td>equiv</td>
<td>equivalent to</td>
</tr>
<tr class="odd">
<td>qed</td>
<td>end of proof</td>
</tr>
<tr class="even">
<td>nabla</td>
<td>a nabla operator</td>
</tr>
<tr class="odd">
<td>sum</td>
<td>sum sign</td>
</tr>
<tr class="even">
<td>prod</td>
<td>product sign</td>
</tr>
<tr class="odd">
<td>exists</td>
<td>there exists sign</td>
</tr>
<tr class="even">
<td>nexists</td>
<td>there is no sign</td>
</tr>
<tr class="odd">
<td>parallel</td>
<td>a parallel sign</td>
</tr>
<tr class="even">
<td>perp</td>
<td>a perpendicular sign</td>
</tr>
<tr class="odd">
<td>leadsto</td>
<td>a leads to sign</td>
</tr>
<tr class="even">
<td>-></td>
<td>a right arrow</td>
</tr>
<tr class="odd">
<td>–></td>
<td>a long right arrow</td>
</tr>
</tbody>
</table>
<p>If a special symbol isn’t in the list it is possible to input arbitrary Unicode characters by pressing <kbd>ESC</kbd> [number of the character (hexadecimal)] <kbd>ESC</kbd>.</p>
<p><kbd>ESC</kbd> <kbd>61</kbd> <kbd>ESC</kbd> therefore results in an <code>a</code>.</p>
<p>Please note that most of these symbols (notable exceptions are the logic symbols) do not have a special meaning in <em>Maxima</em> and therefore will be interpreted as ordinary characters. If <em>Maxima</em> is compiled using a Lisp that doesn’t support dealing with Unicode characters they might cause an error message instead.</p>
<h3 number="1.2.6" id="side-panes"><span class="header-section-number">1.2.6</span> Side Panes</h3>
<p>Shortcuts to the most important <em>Maxima</em> commands or things like a table of contents, windows with debug messages or a history of the last issued commands can be accessed using the side panes. They can be enabled using the “View” menu. They all can be moved to other locations inside or outside the <em>wxMaxima</em> window. Other useful panes is the one that allows to input Greek letters using the mouse.</p>
<div class="figure">
<img src="./SidePanes.png" id="img_SidePanes" alt="" />
<p class="caption">Example of different side panes</p>
</div>
<h3 number="1.2.7" id="mathml-output"><span class="header-section-number">1.2.7</span> MathML output</h3>
<p>Several word processors and similar programs either recognize MathML input and automatically insert it as an editable 2D equation - or (like LibreOffice 5.1) have an equation editor that offers an “import MathML from clipboard” feature. Others support RTF maths. <em>wxMaxima</em> therefore offers several entries in the right-click menu.</p>
<h3 number="1.2.8" id="markdown-support"><span class="header-section-number">1.2.8</span> Markdown support</h3>
<p><em>wxMaxima</em> offers a set of standard markdown conventions that don’t collide with mathematical notation. One of this elements is bullet lists.</p>
<pre><code>Ordinary text
* One item, indentation level 1
* Another item at indentation level 1
* An item at a second indentation level
* A second item at the second indentation level
* A third item at the first indentation level
Ordinary text</code></pre>
<p><em>wxMaxima</em> will recognize text starting with <code>></code> chars as block quotes:</p>
<pre><code>Ordinary text
> quote quote quote quote
> quote quote quote quote
> quote quote quote quote
Ordinary text</code></pre>
<p><em>wxMaxima</em>’s TeX and HTML output will also recognize <code>=></code> and replace it by the corresponding Unicode sign:</p>
<pre><code>cogito => sum.</code></pre>
<p>Other symbols the HTML and TeX export will recognize are <code><=</code> and <code>>=</code> for comparisons, a double-pointed double arrow (<code><=></code>), single- headed arrows (<code><-></code>, <code>-></code> and <code><-</code>) and <code>+/-</code> as the respective sign. For TeX output also <code><<</code> and <code>>></code> are recognized.</p>
<h3 number="1.2.9" id="hotkeys"><span class="header-section-number">1.2.9</span> Hotkeys</h3>
<p>Most hotkeys can be found in the text of the respective menus. Since they are actually taken from the menu text and thus can be customized by the translations of <em>wxMaxima</em> to match the needs of users of the local keyboard, we do not document them here. A few hotkeys or hotkey aliases, though, are not documented in the menus:</p>
<ul>
<li><kbd>CTRL</kbd>+<kbd>SHIFT</kbd>+<kbd>DELETE</kbd> deletes a complete cell.</li>
<li><kbd>CTRL</kbd>+<kbd>TAB</kbd> or <kbd>CTRL</kbd>+<kbd>SHIFT</kbd>+<kbd>TAB</kbd> triggers the auto-completion mechanism.</li>
<li><kbd>SHIFT</kbd>+<kbd>SPACE</kbd> inserts a non-breaking space.</li>
</ul>
<h3 number="1.2.10" id="raw-tex-in-the-tex-export"><span class="header-section-number">1.2.10</span> Raw TeX in the TeX export</h3>
<p>If a text cell begins with <code>TeX:</code> the TeX export contains the literal text that follows the <code>TeX:</code> marker. Using this feature allows the entry of TeX markup within the <em>wxMaxima</em> workbook.</p>
<h2 number="1.3" id="file-formats"><span class="header-section-number">1.3</span> File Formats</h2>
<p>The material that is developed in a <em>wxMaxima</em> session can be stored for later use in any of three ways:</p>
<h3 number="1.3.1" id="mac"><span class="header-section-number">1.3.1</span> .mac</h3>
<p>.mac files are ordinary text files that contain <em>Maxima</em> commands. They can be read using <em>Maxima</em>’s read command or <em>wxMaxima</em>’s File/Batch File menu entry.</p>
<p>One Example:</p>
<p>A .mac file named Quadratic.mac was created. It consists of two commands: <code>f(x) := (x - 5)^2;</code> and <code>wxdraw2d( explicit(f(x),x,-5,15))</code>. The result of entering that batch file appears below. (Some directory path information is deleted.)</p>
<div class="figure">
<img src="./BatchImage.png" id="img_BatchImage" alt="" />
<p class="caption">Batch image</p>
</div>
<div class="sourceCode" id="cb4"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true"></a></span>
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true"></a><span class="fu">read</span>(<span class="st">"test.mac"</span>);</span></code></pre></div>
<p>You can be use <code>.mac</code> files for writing your own library of macros. But since they don’t contain enough structural information they cannot be read back as a <em>wxMaxima</em> session.</p>
<h3 number="1.3.2" id="wxm"><span class="header-section-number">1.3.2</span> .wxm</h3>
<p>.wxm files contain the worksheet except <em>Maxima</em>’s output. On Maxima versions >5.38 they can be read using <em>Maxima</em>’s <code>load()</code> function just as .mac files can be. With this plain-text format it sometimes is unavoidable that worksheets that use new features are not downwards-compatible with older versions of <em>wxMaxima</em>.</p>
<h3 number="1.3.3" id="wxmx"><span class="header-section-number">1.3.3</span> .wxmx</h3>
<p>This XML-based file format saves the complete worksheet including things like the zoom factor and the watchlist. It is the preferred file format.</p>
<h2 number="1.4" id="configuration-options"><span class="header-section-number">1.4</span> Configuration options</h2>
<p>For some common configuration variables <em>wxMaxima</em> offers two ways of configuring:</p>
<ul>
<li>The configuration dialog box below lets you change their default values for the current and subsequent sessions.</li>
<li>Also, the values for most configuration variables can be changed for the current session only by overwriting their values from the worksheet, as shown below.</li>
</ul>
<div class="figure">
<img src="./wxMaxima_configuration_001.png" id="img_wxMaxima_configuration_001" alt="" />
<p class="caption">wxMaxima configuration 1</p>
</div>
<h3 number="1.4.1" id="default-animation-framerate"><span class="header-section-number">1.4.1</span> Default animation framerate</h3>
<p>The animation framerate that is used for new animations is kept in the variable <code>wxanimate_framerate</code>. The initial value this variable will contain in a new worksheet can be changed using the configuration dialogue.</p>
<h3 number="1.4.2" id="default-plot-size-for-new-maxima-sessions"><span class="header-section-number">1.4.2</span> Default plot size for new <em>maxima</em> sessions</h3>
<p>After the next start plots embedded into the worksheet will be created with this size if the value of <code>wxplot_size</code> isn’t changed by <em>maxima</em>.</p>
<p>In order to set the plot size of a single graph only use the following notation can be used that sets a variable’s value for one command only:</p>
<div class="sourceCode" id="cb5"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true"></a><span class="cn">wxdraw2d</span>( </span>
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true"></a> <span class="cn">explicit</span>(</span>
<span id="cb5-3"><a href="#cb5-3" aria-hidden="true"></a> <span class="cn">x</span>^<span class="dv">2</span>,</span>
<span id="cb5-4"><a href="#cb5-4" aria-hidden="true"></a> <span class="cn">x</span>,<span class="dv">-5</span>,<span class="dv">5</span></span>
<span id="cb5-5"><a href="#cb5-5" aria-hidden="true"></a> )</span>
<span id="cb5-6"><a href="#cb5-6" aria-hidden="true"></a>), <span class="cn">wxplot_size</span>=[<span class="dv">480</span>,<span class="dv">480</span>]$</span></code></pre></div>
<h3 number="1.4.3" id="match-parenthesis-in-text-controls"><span class="header-section-number">1.4.3</span> Match parenthesis in text controls</h3>
<p>This option enables two things:</p>
<ul>
<li>If an opening parenthesis, bracket or double quote is entered <em>wxMaxima</em> will insert a closing one after it.</li>
<li>If text is selected if any of these keys is pressed the selected text will be put between the matched signs.</li>
</ul>
<h3 number="1.4.4" id="dont-save-the-worksheet-automatically"><span class="header-section-number">1.4.4</span> Don’t save the worksheet automatically</h3>
<p>If this option is set the file the worksheet is in is overwritten only on request of the user. In case of a crash/power loss/… a recent backup copy is still made available in the temp directory, though.</p>
<p>If this option isn’t set <em>wxMaxima</em> behaves more like a modern cellphone app:</p>
<ul>
<li>Files are saved automatically on exit</li>
<li>And the file will automatically be saved every 3 minutes.</li>
</ul>
<h3 number="1.4.5" id="where-is-the-configuration-saved"><span class="header-section-number">1.4.5</span> Where is the configuration saved?</h3>
<p>If you are using Unix/Linux, the configuration information will be saved in a file <code>.wxMaxima</code> in your home directory (if you are using wxWidgets < 3.1.1), or <code>.config/wxMaxima.conf</code> ((XDG-Standard) if wxWidgets >= 3.1.1 is used). You can retrieve the wxWidgets version from the command <code>wxbuild_info();</code> or by using the menu option Help->About. <a href="https://www.wxwidgets.org/">wxWidgets</a> is the cross-platform GUI library, which is the base for <em>wxMaxima</em> (therefore the <code>wx</code> in the name). (Since the filename starts with a dot, <code>.wxMaxima</code> or <code>.config</code> will be hidden).</p>
<p>If you are using Windows, the configuration will be stored in the registry. You will find the entries for <em>wxMaxima</em> at the following position in the registry: <code>HKEY_CURRENT_USER\Software\wxMaxima</code></p>
<hr />
<h1 number="2" id="extensions-to-maxima"><span class="header-section-number">2</span> Extensions to <em>Maxima</em></h1>
<p><em>wxMaxima</em> is primarily a graphical user interface for <em>Maxima</em>. As such, its main purpose is to pass along commands to <em>Maxima</em> and to report the results of executing those commands. In some cases, however, <em>wxMaxima</em> adds functionality to <em>Maxima</em>. <em>wxMaxima</em>’s ability to generate reports by exporting a workbook’s contents to HTML and LaTeX files has been mentioned. This section considers some ways that <em>wxMaxima</em> enhances the inclusion of graphics into a session.</p>
<h2 number="2.1" id="subscripted-variables"><span class="header-section-number">2.1</span> Subscripted variables</h2>
<p>if <code>wxsubscripts</code> is set to true variable names of the format <code>x_y</code> are displayed using a subscript if</p>
<ul>
<li><code>y</code> is a single letter</li>
<li><code>y</code> is an integer</li>
</ul>
<p>If the variable name doesn’t match these requirements it can still be declared as “to be subscripted” using the command <code>wxdeclare_subscript(variable_name);</code> or <code>wxdeclare_subscript([variable_name1,variable_name2,...]);</code> Declaring a variable as subscripted can be reverted using the following command: <code>wxdeclare_subscript(variable_name,false);</code></p>
<h2 number="2.2" id="user-feedback-in-the-status-bar"><span class="header-section-number">2.2</span> User feedback in the status bar</h2>
<p>Long-running commands can provide user-feedback in the status bar. This user feedback is replaced by any new feedback that is placed there (allowing to use it as a progress indicator) and is deleted as soon as the current command sent to <em>Maxima</em> is finished. It is safe to use <code>wxstatusbar()</code> even in libraries that might be used with plain <em>Maxima</em> (as opposed to <em>wxMaxima</em>): If <em>wxMaxima</em> isn’t present the <code>wxstatusbar()</code> command will just be left unevaluated.</p>
<div class="sourceCode" id="cb6"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true"></a><span class="kw">for</span> <span class="cn">i</span>:<span class="dv">1</span> <span class="kw">thru</span> <span class="dv">10</span> <span class="kw">do</span> (</span>
<span id="cb6-2"><a href="#cb6-2" aria-hidden="true"></a> <span class="co">/* Tell the user how far we got */</span></span>
<span id="cb6-3"><a href="#cb6-3" aria-hidden="true"></a> <span class="cn">wxstatusbar</span>(<span class="fu">concat</span>(<span class="st">"Pass "</span>,<span class="cn">i</span>)),</span>
<span id="cb6-4"><a href="#cb6-4" aria-hidden="true"></a> <span class="co">/* (sleep n) is a Lisp function, which can be used */</span></span>
<span id="cb6-5"><a href="#cb6-5" aria-hidden="true"></a> <span class="co">/* with the character "?" before. It delays the */</span></span>
<span id="cb6-6"><a href="#cb6-6" aria-hidden="true"></a> <span class="co">/* program execution (here: for 3 seconds) */</span></span>
<span id="cb6-7"><a href="#cb6-7" aria-hidden="true"></a> ?<span class="cn">sleep</span>(<span class="dv">3</span>)</span>
<span id="cb6-8"><a href="#cb6-8" aria-hidden="true"></a>)$</span></code></pre></div>
<h2 number="2.3" id="plotting"><span class="header-section-number">2.3</span> Plotting</h2>
<p>Plotting (having fundamentally to do with graphics) is a place where a graphical user interface will have to provide some extensions to the original program.</p>
<h3 number="2.3.1" id="embedding-a-plot-into-the-work-sheet"><span class="header-section-number">2.3.1</span> Embedding a plot into the work sheet</h3>
<p><em>Maxima</em> normally instructs the external program <em>gnuplot</em> to open a separate window for every diagram it creates. Since many times it is convenient to embed graphs into the work sheet instead <em>wxMaxima</em> provides its own set of plot functions that don’t differ from the corresponding <em>maxima</em> functions save in their name: They are all prefixed by a “wx”. For example <code>wxplot2d</code> corresponds to <code>plot2d</code>, <code>wxplot3d</code> corresponds to <code>plot3d</code>, <code>wxdraw</code> corresponds to <code>draw</code> and <code>wxhistogram</code> corresponds to <code>histogram</code>.</p>
<h3 number="2.3.2" id="making-embedded-plots-bigger-or-smaller"><span class="header-section-number">2.3.2</span> Making embedded plots bigger or smaller</h3>
<p>As noted above, the configure dialog provides a way to change the default size plots are created with which sets the starting value of <code>wxplot_size</code>. The plotting routines of <em>wxMaxima</em> respect this variable that specifies the size of a plot in pixels. It can always be queried or used to set the size of the following plots:</p>
<div class="sourceCode" id="cb7"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true"></a><span class="cn">wxplot_size</span>:[<span class="dv">1200</span>,<span class="dv">800</span>]$</span>
<span id="cb7-2"><a href="#cb7-2" aria-hidden="true"></a><span class="cn">wxdraw2d</span>(</span>
<span id="cb7-3"><a href="#cb7-3" aria-hidden="true"></a> <span class="cn">explicit</span>(</span>
<span id="cb7-4"><a href="#cb7-4" aria-hidden="true"></a> <span class="fu">sin</span>(<span class="cn">x</span>),</span>
<span id="cb7-5"><a href="#cb7-5" aria-hidden="true"></a> <span class="cn">x</span>,<span class="dv">1</span>,<span class="dv">10</span></span>
<span id="cb7-6"><a href="#cb7-6" aria-hidden="true"></a> )</span>
<span id="cb7-7"><a href="#cb7-7" aria-hidden="true"></a>)$</span></code></pre></div>
<p>If the size of only one plot is to be changed <em>Maxima</em> provides a canonical way to change an attribute only for the current cell. In this usage the specification <code>wxplot_size = [value1, value2]</code> is appended to the <code>wxdraw2d( )</code> command, and is not part of the <code>wxdraw2d</code> command.</p>
<div class="sourceCode" id="cb8"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true"></a><span class="cn">wxdraw2d</span>(</span>
<span id="cb8-2"><a href="#cb8-2" aria-hidden="true"></a> <span class="cn">explicit</span>(</span>
<span id="cb8-3"><a href="#cb8-3" aria-hidden="true"></a> <span class="fu">sin</span>(<span class="cn">x</span>),</span>
<span id="cb8-4"><a href="#cb8-4" aria-hidden="true"></a> <span class="cn">x</span>,<span class="dv">1</span>,<span class="dv">10</span></span>
<span id="cb8-5"><a href="#cb8-5" aria-hidden="true"></a> )</span>
<span id="cb8-6"><a href="#cb8-6" aria-hidden="true"></a>),<span class="cn">wxplot_size</span>=[<span class="dv">1600</span>,<span class="dv">800</span>]$</span></code></pre></div>
<h3 number="2.3.3" id="better-quality-plots"><span class="header-section-number">2.3.3</span> Better quality plots</h3>
<p><em>Gnuplot</em> doesn’t seem to provide a portable way of determining whether it supports the high-quality bitmap output that the cairo library provides. On systems where <em>gnuplot</em> is compiled to use this library the pngcairo option from the configuration menu (that can be overridden by the variable <code>wxplot_pngcairo</code>) enables support for antialiasing and additional line styles. If <code>wxplot_pngcairo</code> is set without <em>gnuplot</em> supporting this the result will be error messages instead of graphics.</p>
<h3 number="2.3.4" id="opening-embedded-plots-in-interactive-gnuplot-windows"><span class="header-section-number">2.3.4</span> Opening embedded plots in interactive <em>gnuplot</em> windows</h3>
<p>If a plot was generated using the <code>wxdraw</code>-type commands (<code>wxplot2d</code> and <code>wxplot3d</code> isn’t supported by this feature) and the file size of the underlying <em>gnuplot</em> project isn’t way too high <em>wxMaxima</em> offers a right-click menu that allows to open the plot in an interactive <em>gnuplot</em> window.</p>
<h3 number="2.3.5" id="opening-gnuplots-command-console-in-plot-windows"><span class="header-section-number">2.3.5</span> Opening gnuplot’s command console in <code>plot</code> windows</h3>
<p>On MS Windows, if in <em>Maxima</em>’s variable <code>gnuplot_command</code> “gnuplot” is replaced by “wgnuplot”, <em>gnuplot</em> offers the possibility to open a console window, where <em>gnuplot</em> commands can be entered into. Unfortunately, enabling this feature causes <em>gnuplot</em> to “steal” the keyboard focus for a short time every time a plot is prepared.</p>
<h3 number="2.3.6" id="embedding-animations-into-the-spreadsheet"><span class="header-section-number">2.3.6</span> Embedding animations into the spreadsheet</h3>
<p>3D diagrams tend to make it hard to read quantitative data. A viable alternative might be to assign the 3rd parameter to the mouse wheel. The <code>with_slider_draw</code> command is a version of <code>wxdraw2d</code> that does prepare multiple plots and allows to switch between them by moving the slider on top of the screen. <em>wxMaxima</em> allows to export this animation as an animated gif.</p>
<p>The first two arguments for <code>with_slider_draw</code> are the name of the variable that is stepped between the plots and a list of the values of these variable. The arguments that follow are the ordinary arguments for <code>wxdraw2d</code>:</p>
<div class="sourceCode" id="cb9"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true"></a><span class="cn">with_slider_draw</span>(</span>
<span id="cb9-2"><a href="#cb9-2" aria-hidden="true"></a> <span class="cn">f</span>,[<span class="dv">1</span>,<span class="dv">2</span>,<span class="dv">3</span>,<span class="dv">4</span>,<span class="dv">5</span>,<span class="dv">6</span>,<span class="dv">7</span>,<span class="dv">10</span>],</span>
<span id="cb9-3"><a href="#cb9-3" aria-hidden="true"></a> <span class="cn">title</span>=<span class="fu">concat</span>(<span class="st">"f="</span>,<span class="cn">f</span>,<span class="st">"Hz"</span>),</span>
<span id="cb9-4"><a href="#cb9-4" aria-hidden="true"></a> <span class="cn">explicit</span>(</span>
<span id="cb9-5"><a href="#cb9-5" aria-hidden="true"></a> <span class="fu">sin</span>(<span class="dv">2</span>*<span class="va">%pi</span>*<span class="cn">f</span>*<span class="cn">x</span>),</span>
<span id="cb9-6"><a href="#cb9-6" aria-hidden="true"></a> <span class="cn">x</span>,<span class="dv">0</span>,<span class="dv">1</span></span>
<span id="cb9-7"><a href="#cb9-7" aria-hidden="true"></a> ),<span class="cn">grid</span>=<span class="kw">true</span></span>
<span id="cb9-8"><a href="#cb9-8" aria-hidden="true"></a>);</span></code></pre></div>
<p>The same functionality for 3D plots is accessible as <code>with_slider_draw3d</code>, which allows for rotating 3d plots:</p>
<div class="sourceCode" id="cb10"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true"></a><span class="cn">wxanimate_autoplay</span>:<span class="kw">true</span>;</span>
<span id="cb10-2"><a href="#cb10-2" aria-hidden="true"></a><span class="cn">wxanimate_framerate</span>:<span class="dv">20</span>;</span>
<span id="cb10-3"><a href="#cb10-3" aria-hidden="true"></a><span class="cn">with_slider_draw3d</span>(</span>
<span id="cb10-4"><a href="#cb10-4" aria-hidden="true"></a> α,<span class="fu">makelist</span>(<span class="cn">i</span>,<span class="cn">i</span>,<span class="dv">1</span>,<span class="dv">360</span>,<span class="dv">3</span>),</span>
<span id="cb10-5"><a href="#cb10-5" aria-hidden="true"></a> <span class="cn">title</span>=<span class="fu">sconcat</span>(<span class="st">"α="</span>,α),</span>
<span id="cb10-6"><a href="#cb10-6" aria-hidden="true"></a> <span class="cn">surface_hide</span>=<span class="kw">true</span>,</span>
<span id="cb10-7"><a href="#cb10-7" aria-hidden="true"></a> <span class="cn">contour</span>=<span class="cn">both</span>,</span>
<span id="cb10-8"><a href="#cb10-8" aria-hidden="true"></a> <span class="cn">view</span>=[<span class="dv">60</span>,α],</span>
<span id="cb10-9"><a href="#cb10-9" aria-hidden="true"></a> <span class="cn">explicit</span>(</span>
<span id="cb10-10"><a href="#cb10-10" aria-hidden="true"></a> <span class="fu">sin</span>(<span class="cn">x</span>)*<span class="fu">sin</span>(<span class="cn">y</span>),</span>
<span id="cb10-11"><a href="#cb10-11" aria-hidden="true"></a> <span class="cn">x</span>,-π,π,</span>
<span id="cb10-12"><a href="#cb10-12" aria-hidden="true"></a> <span class="cn">y</span>,-π,π</span>
<span id="cb10-13"><a href="#cb10-13" aria-hidden="true"></a> )</span>
<span id="cb10-14"><a href="#cb10-14" aria-hidden="true"></a>)$</span></code></pre></div>
<p>If the general shape of the plot is what matters it might suffice to move the plot just a little bit in order to make its 3D nature available to the intuition:</p>
<div class="sourceCode" id="cb11"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true"></a><span class="cn">wxanimate_autoplay</span>:<span class="kw">true</span>;</span>
<span id="cb11-2"><a href="#cb11-2" aria-hidden="true"></a><span class="cn">wxanimate_framerate</span>:<span class="dv">20</span>;</span>
<span id="cb11-3"><a href="#cb11-3" aria-hidden="true"></a><span class="cn">with_slider_draw3d</span>(</span>
<span id="cb11-4"><a href="#cb11-4" aria-hidden="true"></a> <span class="cn">t</span>,<span class="fu">makelist</span>(<span class="cn">i</span>,<span class="cn">i</span>,<span class="dv">0</span>,<span class="dv">2</span>*π,<span class="fl">.05</span>*π),</span>
<span id="cb11-5"><a href="#cb11-5" aria-hidden="true"></a> <span class="cn">title</span>=<span class="fu">sconcat</span>(<span class="st">"α="</span>,α),</span>
<span id="cb11-6"><a href="#cb11-6" aria-hidden="true"></a> <span class="cn">surface_hide</span>=<span class="kw">true</span>,</span>
<span id="cb11-7"><a href="#cb11-7" aria-hidden="true"></a> <span class="cn">contour</span>=<span class="cn">both</span>,</span>
<span id="cb11-8"><a href="#cb11-8" aria-hidden="true"></a> <span class="cn">view</span>=[<span class="dv">60</span>,<span class="dv">30+5</span>*<span class="fu">sin</span>(<span class="cn">t</span>)],</span>
<span id="cb11-9"><a href="#cb11-9" aria-hidden="true"></a> <span class="cn">explicit</span>(</span>
<span id="cb11-10"><a href="#cb11-10" aria-hidden="true"></a> <span class="fu">sin</span>(<span class="cn">x</span>)*<span class="cn">y</span>^<span class="dv">2</span>,</span>
<span id="cb11-11"><a href="#cb11-11" aria-hidden="true"></a> <span class="cn">x</span>,<span class="dv">-2</span>*π,<span class="dv">2</span>*π,</span>
<span id="cb11-12"><a href="#cb11-12" aria-hidden="true"></a> <span class="cn">y</span>,<span class="dv">-2</span>*π,<span class="dv">2</span>*π</span>
<span id="cb11-13"><a href="#cb11-13" aria-hidden="true"></a> )</span>
<span id="cb11-14"><a href="#cb11-14" aria-hidden="true"></a>)$</span></code></pre></div>
<p>For those more familiar with <code>plot</code> than with <code>draw</code> there is a second set of functions:</p>
<ul>
<li><code>with_slider</code> and</li>
<li><code>wxanimate</code>.</li>
</ul>
<p>Normally the animations are played back or exported with the frame rate chosen in the configuration of <em>wxMaxima</em>. To set the speed an individual animation is played back the variable <code>wxanimate_framerate</code> can be used:</p>
<div class="sourceCode" id="cb12"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb12-1"><a href="#cb12-1" aria-hidden="true"></a><span class="cn">wxanimate</span>(<span class="cn">a</span>, <span class="dv">10</span>,</span>
<span id="cb12-2"><a href="#cb12-2" aria-hidden="true"></a> <span class="fu">sin</span>(<span class="cn">a</span>*<span class="cn">x</span>), [<span class="cn">x</span>,<span class="dv">-5</span>,<span class="dv">5</span>]), <span class="cn">wxanimate_framerate</span>=<span class="dv">6</span>$</span></code></pre></div>
<p>The animation functions use <em>Maxima</em>’s <code>makelist</code> command and therefore shares the pitfall that the slider variable’s value is substituted into the expression only if the variable is directly visible in the expression. Therefore the following example will fail:</p>
<div class="sourceCode" id="cb13"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true"></a><span class="cn">f</span>:<span class="fu">sin</span>(<span class="cn">a</span>*<span class="cn">x</span>);</span>
<span id="cb13-2"><a href="#cb13-2" aria-hidden="true"></a><span class="cn">with_slider_draw</span>(</span>
<span id="cb13-3"><a href="#cb13-3" aria-hidden="true"></a> <span class="cn">a</span>,<span class="fu">makelist</span>(<span class="cn">i</span>/<span class="dv">2</span>,<span class="cn">i</span>,<span class="dv">1</span>,<span class="dv">10</span>),</span>
<span id="cb13-4"><a href="#cb13-4" aria-hidden="true"></a> <span class="cn">title</span>=<span class="fu">concat</span>(<span class="st">"a="</span>,<span class="fu">float</span>(<span class="cn">a</span>)),</span>
<span id="cb13-5"><a href="#cb13-5" aria-hidden="true"></a> <span class="cn">grid</span>=<span class="kw">true</span>,</span>
<span id="cb13-6"><a href="#cb13-6" aria-hidden="true"></a> <span class="cn">explicit</span>(<span class="cn">f</span>,<span class="cn">x</span>,<span class="dv">0</span>,<span class="dv">10</span>)</span>
<span id="cb13-7"><a href="#cb13-7" aria-hidden="true"></a>)$</span></code></pre></div>
<p>If <em>Maxima</em> is explicitly asked to substitute the slider’s value plotting works fine instead:</p>
<div class="sourceCode" id="cb14"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true"></a><span class="cn">f</span>:<span class="fu">sin</span>(<span class="cn">a</span>*<span class="cn">x</span>);</span>
<span id="cb14-2"><a href="#cb14-2" aria-hidden="true"></a><span class="cn">with_slider_draw</span>(</span>
<span id="cb14-3"><a href="#cb14-3" aria-hidden="true"></a> <span class="cn">b</span>,<span class="fu">makelist</span>(<span class="cn">i</span>/<span class="dv">2</span>,<span class="cn">i</span>,<span class="dv">1</span>,<span class="dv">10</span>),</span>
<span id="cb14-4"><a href="#cb14-4" aria-hidden="true"></a> <span class="cn">title</span>=<span class="fu">concat</span>(<span class="st">"a="</span>,<span class="fu">float</span>(<span class="cn">b</span>)),</span>
<span id="cb14-5"><a href="#cb14-5" aria-hidden="true"></a> <span class="cn">grid</span>=<span class="kw">true</span>,</span>
<span id="cb14-6"><a href="#cb14-6" aria-hidden="true"></a> <span class="cn">explicit</span>(</span>
<span id="cb14-7"><a href="#cb14-7" aria-hidden="true"></a> <span class="fu">subst</span>(<span class="cn">a</span>=<span class="cn">b</span>,<span class="cn">f</span>),</span>
<span id="cb14-8"><a href="#cb14-8" aria-hidden="true"></a> <span class="cn">x</span>,<span class="dv">0</span>,<span class="dv">10</span></span>
<span id="cb14-9"><a href="#cb14-9" aria-hidden="true"></a> )</span>
<span id="cb14-10"><a href="#cb14-10" aria-hidden="true"></a>)$</span></code></pre></div>
<h3 number="2.3.7" id="opening-multiple-plots-in-contemporaneous-windows"><span class="header-section-number">2.3.7</span> Opening multiple plots in contemporaneous windows</h3>
<p>While not being a provided by <em>wxMaxima</em> this feature of <em>Maxima</em> (on setups that support it) sometimes comes in handily. The following example comes from a post from Mario Rodriguez to the <em>Maxima</em> mailing list:</p>
<div class="sourceCode" id="cb15"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb15-1"><a href="#cb15-1" aria-hidden="true"></a> <span class="fu">load</span>(<span class="fu">draw</span>);</span>
<span id="cb15-2"><a href="#cb15-2" aria-hidden="true"></a> </span>
<span id="cb15-3"><a href="#cb15-3" aria-hidden="true"></a> <span class="co">/* Parabola in window #1 */</span></span>
<span id="cb15-4"><a href="#cb15-4" aria-hidden="true"></a> <span class="fu">draw2d</span>(<span class="cn">terminal</span>=[<span class="cn">wxt</span>,<span class="dv">1</span>],<span class="cn">explicit</span>(<span class="cn">x</span>^<span class="dv">2</span>,<span class="cn">x</span>,<span class="dv">-1</span>,<span class="dv">1</span>));</span>
<span id="cb15-5"><a href="#cb15-5" aria-hidden="true"></a> </span>
<span id="cb15-6"><a href="#cb15-6" aria-hidden="true"></a> <span class="co">/* Parabola in window #2 */</span></span>
<span id="cb15-7"><a href="#cb15-7" aria-hidden="true"></a> <span class="fu">draw2d</span>(<span class="cn">terminal</span>=[<span class="cn">wxt</span>,<span class="dv">2</span>],<span class="cn">explicit</span>(<span class="cn">x</span>^<span class="dv">2</span>,<span class="cn">x</span>,<span class="dv">-1</span>,<span class="dv">1</span>));</span>
<span id="cb15-8"><a href="#cb15-8" aria-hidden="true"></a> </span>
<span id="cb15-9"><a href="#cb15-9" aria-hidden="true"></a> <span class="co">/* Paraboloid in window #3 */</span></span>
<span id="cb15-10"><a href="#cb15-10" aria-hidden="true"></a> <span class="fu">draw3d</span>(<span class="cn">terminal</span>=[<span class="cn">wxt</span>,<span class="dv">3</span>],<span class="cn">explicit</span>(<span class="cn">x</span>^<span class="dv">2</span>+<span class="cn">y</span>^<span class="dv">2</span>,<span class="cn">x</span>,<span class="dv">-1</span>,<span class="dv">1</span>,<span class="cn">y</span>,<span class="dv">-1</span>,<span class="dv">1</span>));</span></code></pre></div>
<p>Plotting multiple plots in the same window is possible, too:</p>
<div class="sourceCode" id="cb16"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true"></a> <span class="cn">wxdraw</span>(</span>
<span id="cb16-2"><a href="#cb16-2" aria-hidden="true"></a> <span class="cn">gr2d</span>(</span>
<span id="cb16-3"><a href="#cb16-3" aria-hidden="true"></a> <span class="cn">key</span>=<span class="st">"sin (x)"</span>,<span class="cn">grid</span>=[<span class="dv">2</span>,<span class="dv">2</span>],</span>
<span id="cb16-4"><a href="#cb16-4" aria-hidden="true"></a> <span class="cn">explicit</span>(<span class="fu">sin</span>(<span class="cn">x</span>),<span class="cn">x</span>,<span class="dv">0</span>,<span class="dv">2</span>*<span class="va">%pi</span>)),</span>
<span id="cb16-5"><a href="#cb16-5" aria-hidden="true"></a> <span class="cn">gr2d</span>(</span>
<span id="cb16-6"><a href="#cb16-6" aria-hidden="true"></a> <span class="cn">key</span>=<span class="st">"cos (x)"</span>,<span class="cn">grid</span>=[<span class="dv">2</span>,<span class="dv">2</span>],</span>
<span id="cb16-7"><a href="#cb16-7" aria-hidden="true"></a> <span class="cn">explicit</span>(<span class="fu">cos</span>(<span class="cn">x</span>),<span class="cn">x</span>,<span class="dv">0</span>,<span class="dv">2</span>*<span class="va">%pi</span>))</span>
<span id="cb16-8"><a href="#cb16-8" aria-hidden="true"></a> );</span></code></pre></div>
<h3 number="2.3.8" id="the-plot-using-draw-side-pane"><span class="header-section-number">2.3.8</span> The “Plot using draw” side pane</h3>
<p>The “Plot using draw” sidebar hides a simple code generator that allows to generate scenes that make use of some of the flexibility of the <em>draw</em> package <em>maxima</em> comes with.</p>
<h4 number="2.3.8.1" id="d"><span class="header-section-number">2.3.8.1</span> 2D</h4>
<p>Generates the skeleton of a <code>draw()</code> command that draws a 2D scene. This scene later has to be filled with commands that generate the scene’s contents, for example by using the buttons in the rows below the “2D” button.</p>
<p>One helpful feature of the 2D button is that it allows to setup the scene as an animation in which a variable (by default it is <em>t</em>) has a different value in each frame: Often an moving 2D plot allows easier interpretation than the same data in a non-moving 3D one.</p>
<h4 number="2.3.8.2" id="d-1"><span class="header-section-number">2.3.8.2</span> 3D</h4>
<p>Generates the skeleton of a <code>draw()</code> command that draws a 3D scene. If neither a 2D or a 3D scene are set up all of the other buttons set up a 2D scene that contains the command the button generates.</p>
<h4 number="2.3.8.3" id="expression"><span class="header-section-number">2.3.8.3</span> Expression</h4>
<p>Appends a standard plot of an expression like <code>sin(x)</code>, <code>x*sin(x)</code> or <code>x^2+2*x-4</code> to the <code>draw()</code> command the cursor currently is in. If there is no draw command a 2D scene with the plot is generated. Each scene can be filled with any number of plots.</p>
<h4 number="2.3.8.4" id="implicit-plot"><span class="header-section-number">2.3.8.4</span> Implicit plot</h4>
<p>Tries to find all points an expression like <code>y=sin(x)</code>, <code>y*sin(x)=3</code> or <code>x^2+y^2=4</code> is true at and plots the resulting curve in the <code>draw()</code> command the cursor currently is in. If there is no draw command a 2D scene with the plot is generated.</p>
<h4 number="2.3.8.5" id="parametric-plot"><span class="header-section-number">2.3.8.5</span> Parametric plot</h4>
<p>Steps a variable from a lower limit to an upper limit and uses two expressions like <code>t*sin(t)</code> and <code>t*cos(t)</code> for generating the x, y (and in 3D plots also z) coordinates of a curve that is put into the current draw command.</p>
<h4 number="2.3.8.6" id="points"><span class="header-section-number">2.3.8.6</span> Points</h4>
<p>Draws many points that can optionally be joined. The coordinates of the points are taken from a list of lists, a 2D array or one list or array for each axis.</p>
<h4 number="2.3.8.7" id="diagram-title"><span class="header-section-number">2.3.8.7</span> Diagram title</h4>
<p>Draws a title on the upper end of the diagram,</p>
<h4 number="2.3.8.8" id="axis"><span class="header-section-number">2.3.8.8</span> Axis</h4>
<p>Sets up the axis.</p>
<h4 number="2.3.8.9" id="contour"><span class="header-section-number">2.3.8.9</span> Contour</h4>
<p>(Only for 3D plots): Adds contour lines similar to the ones one can find in a map of a mountain to the plot commands that follow in the current <code>draw()</code> command and/or to the ground plane of the diagram. Alternatively this wizard allows skipping drawing the curves entirely only showing the contour plot.</p>
<h4 number="2.3.8.10" id="plot-name"><span class="header-section-number">2.3.8.10</span> Plot name</h4>
<p>Adds a legend entry showing the next plot’s name to the legend of the diagram. An empty name disables generating legend entries for the following plots.</p>
<h4 number="2.3.8.11" id="line-colour"><span class="header-section-number">2.3.8.11</span> Line colour</h4>
<p>Sets the line colour for the following plots the current draw command contains.</p>
<h4 number="2.3.8.12" id="fill-colour"><span class="header-section-number">2.3.8.12</span> Fill colour</h4>
<p>Sets the fill colour for the following plots the current draw command contains.</p>
<h4 number="2.3.8.13" id="grid"><span class="header-section-number">2.3.8.13</span> Grid</h4>
<p>Pops up a wizard that allows to set up grid lines.</p>
<h4 number="2.3.8.14" id="accuracy"><span class="header-section-number">2.3.8.14</span> Accuracy</h4>
<p>Allows to select an adequate point in the speed vs. accuracy tradeoff that is part of any plot program.</p>
<h2 number="2.4" id="embedding-graphics"><span class="header-section-number">2.4</span> Embedding graphics</h2>
<p>If the <code>.wxmx</code> file format is being used embedding files in a <em>wxMaxima</em> project can be done as easily as per drag-and-drop. But sometimes (for example if an image’s contents might change later on in a session) it is better to tell the file to load the image on evaluation:</p>
<div class="sourceCode" id="cb17"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb17-1"><a href="#cb17-1" aria-hidden="true"></a><span class="cn">show_image</span>(<span class="st">"man.png"</span>);</span></code></pre></div>
<h2 number="2.5" id="startup-files"><span class="header-section-number">2.5</span> Startup files</h2>
<p>The config dialogue of <em>wxMaxima</em> offers to edit two files with commands that are executed on startup:</p>
<ul>
<li>A file that contains commands that are executed on starting up <em>Maxima</em>: <code>maxima-init.mac</code></li>
<li>one file of additional commands that are executed if <em>wxMaxima</em> is starting <em>Maxima</em>: <code>wxmaxima-init.mac</code></li>
</ul>
<p>These files are in the Maxima user directory (usually <code>maxima</code> in Windows, <code>.maxima</code> otherwise) in the user’s home directory / user profile directory. The location can be found out with the command: <code>maxima_userdir;</code></p>
<h2 number="2.6" id="special-variables-wx"><span class="header-section-number">2.6</span> Special variables wx…</h2>
<ul>
<li><code>wxsubscripts</code> tells <em>Maxima</em> if it should convert variable names that contain an underscore (<code>R_150</code> or the like) into subscripted variables. See <code>wxdeclare_subscript</code> for details which variable names are automatically converted.</li>
<li><code>wxfilename</code>: This variable contains the name of the file currently opened in <em>wxMaxima</em>.</li>
<li><code>wxplot_pngcairo</code> tells whether <em>wxMaxima</em> tries to use <em>gnuplot</em>’s pngcairo terminal that provides more line styles and a better overall graphics quality.</li>
<li><code>wxplot_size</code> defines the resolution of embedded plots.</li>
<li><code>wxchangedir</code>: On most operating systems <em>wxMaxima</em> automatically sets <em>Maxima</em>’s working directory to the directory of the current file. This allows file I/O (e.g. by <code>read_matrix</code>) to work without specifying the whole path to the file that has to be read or written. On Windows this feature sometimes causes error messages and therefore can be set to <code>false</code> from the config dialogue.</li>
<li><code>wxanimate_framerate</code>: The number of frames per second the following animations have to be played back with.</li>
<li><code>wxanimate_autoplay</code>: Automatically play animations by default?</li>
</ul>
<h2 number="2.7" id="pretty-printing-2d-output"><span class="header-section-number">2.7</span> Pretty-printing 2D output</h2>
<p>The function <code>table_form()</code> displays a 2D list in a form that is more readable than the output from <em>Maxima</em>’s default output routine. The input is a list of one or more lists. Like the “print” command, this command displays output even when ended with a dollar sign. Ending the command with a semicolon results in the same table along with a “done” statement.</p>
<div class="sourceCode" id="cb18"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb18-1"><a href="#cb18-1" aria-hidden="true"></a><span class="cn">table_form</span>(</span>
<span id="cb18-2"><a href="#cb18-2" aria-hidden="true"></a> [</span>
<span id="cb18-3"><a href="#cb18-3" aria-hidden="true"></a> [<span class="dv">1</span>,<span class="dv">2</span>],</span>
<span id="cb18-4"><a href="#cb18-4" aria-hidden="true"></a> [<span class="dv">3</span>,<span class="dv">4</span>]</span>
<span id="cb18-5"><a href="#cb18-5" aria-hidden="true"></a> ]</span>
<span id="cb18-6"><a href="#cb18-6" aria-hidden="true"></a>)$</span></code></pre></div>
<p>As the next example shows, the lists that are assembled by the <code>table_form</code> command can be created before the command is executed.</p>
<div class="figure">
<img src="./MatrixTableExample.png" id="img_MatrixTableExample" alt="" />
<p class="caption">A third table example</p>
</div>
<p>Also, because a matrix is a list of lists, matrices can be converted to tables in a similar fashion.</p>
<div class="figure">
<img src="./SecondTableExample.png" id="img_SecondTableExample" alt="" />
<p class="caption">Another table_form example</p>
</div>
<h2 number="2.8" id="bug-reporting"><span class="header-section-number">2.8</span> Bug reporting</h2>
<p><em>wxMaxima</em> provides a few functions that gather bug reporting information about the current system:</p>
<ul>
<li><code>wxbuild_info()</code> gathers information about the currently running version of <em>wxMaxima</em></li>
<li><code>wxbug_report()</code> tells how and where to file bugs</li>
</ul>
<h2 number="2.9" id="marking-output-being-drawn-in-red"><span class="header-section-number">2.9</span> Marking output being drawn in red</h2>
<p><em>Maxima</em>’s <code>box()</code> command causes <em>wxMaxima</em> to print its argument with a red foreground.</p>
<hr />
<h1 number="3" id="troubleshooting"><span class="header-section-number">3</span> Troubleshooting</h1>
<h2 number="3.1" id="cannot-connect-to-maxima"><span class="header-section-number">3.1</span> Cannot connect to <em>Maxima</em></h2>
<p>Since <em>Maxima</em> (the program that does the actual mathematics) and <em>wxMaxima</em> (providing the easy-to-use user interface) are separate programs that communicate by the means of a local network connection. Therefore the most probable cause is that this connection is somehow not working. For example a firewall could be set up in a way that it doesn’t just prevent unauthorized connections from the internet (and perhaps to intercept some connections to the internet, too), but it also to blocks inter-process-communication inside the same computer. Note that since <em>Maxima</em> is being run by a Lisp processor the process communication that is blocked from does not necessarily have to be named “maxima”. Common names of the program that opens the network connection would be sbcl, gcl, ccl, lisp.exe or similar names.</p>
<p>On Un*x computers another possible reason would be that the loopback network that provides network connections between two programs in the same computer isn’t properly configured.</p>
<h2 number="3.2" id="how-to-save-data-from-a-broken-.wxmx-file"><span class="header-section-number">3.2</span> How to save data from a broken .wxmx file</h2>
<p>Internally most modern XML-based formats are ordinary zip-files. <em>wxMaxima</em> doesn’t turn on compression, so the contents of .wxmx files can be viewed in any text editor.</p>
<p>If the zip signature at the end of the file is still intact after renaming a broken .wxmx file to .zip most operating systems will provide a way to extract any portion of information that is stored inside it. This can be done when there is the need of recovering the original image files from a text processor document. If the zip signature isn’t intact that does not need to be the end of the world: If <em>wxMaxima</em> during saving detected that something went wrong there will be a <code>wxmx~</code> file whose contents might help.</p>
<p>And even if there isn’t such a file: The <code>.wxmx</code> file is a container format and the XML portion is stored uncompressed. It it is possible to rename the <code>.wxmx</code> file to a <code>.txt</code> file and to use a text editor to recover the XML portion of the file’s contents (it starts with <code><?xml version="1.0" encoding="UTF-8"?></code> and ends with <code></wxMaximaDocument></code>. Before and after that text you will see some unreadable binary contents in the text editor).</p>
<p>If a text file containing only this contents (e.g. copy and paste this text into a new file) is saved as a file ending in <code>.xml</code>, <em>wxMaxima</em> will know how to recover the text of the document from it.</p>
<h2 number="3.3" id="i-want-some-debug-info-to-be-displayed-on-the-screen-before-my-command-has-finished"><span class="header-section-number">3.3</span> I want some debug info to be displayed on the screen before my command has finished</h2>
<p>Normally <em>wxMaxima</em> waits for the whole 2D formula to be transferred before it begins to typeset. This saves time for making many attempts to typeset a only partially completed equation. There is a <code>disp</code> command, though, that will provide debug output immediately and without waiting for the current <em>Maxima</em> command to finish:</p>
<div class="sourceCode" id="cb19"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb19-1"><a href="#cb19-1" aria-hidden="true"></a><span class="kw">for</span> <span class="cn">i</span>:<span class="dv">1</span> <span class="kw">thru</span> <span class="dv">10</span> <span class="kw">do</span> (</span>
<span id="cb19-2"><a href="#cb19-2" aria-hidden="true"></a> <span class="fu">disp</span>(<span class="cn">i</span>),</span>
<span id="cb19-3"><a href="#cb19-3" aria-hidden="true"></a> <span class="co">/* (sleep n) is a Lisp function, which can be used */</span></span>
<span id="cb19-4"><a href="#cb19-4" aria-hidden="true"></a> <span class="co">/* with the character "?" before. It delays the */</span></span>
<span id="cb19-5"><a href="#cb19-5" aria-hidden="true"></a> <span class="co">/* program execution (here: for 3 seconds) */</span></span>
<span id="cb19-6"><a href="#cb19-6" aria-hidden="true"></a> ?<span class="cn">sleep</span>(<span class="dv">3</span>)</span>
<span id="cb19-7"><a href="#cb19-7" aria-hidden="true"></a>)$</span></code></pre></div>
<h2 number="3.4" id="plotting-only-shows-a-closed-empty-envelope-with-an-error-message"><span class="header-section-number">3.4</span> Plotting only shows a closed empty envelope with an error message</h2>
<p>This means that <em>wxMaxima</em> could not read the file <em>Maxima</em> that was supposed to instruct <em>gnuplot</em> to create.</p>
<p>Possible reasons for this error are:</p>
<ul>
<li>The plotting command is part of a third-party package like <code>implicit_plot</code> but this package was not loaded by <em>Maxima</em>’s <code>load()</code> command before trying to plot.</li>
<li><em>Maxima</em> tried to do something the currently installed version of <em>gnuplot</em> isn’t able to understand. In this case, a file ending in <code>.gnuplot</code> located in the directory, which <em>Maxima</em>’s variable <code>maxima_userdir</code> is pointing, contains the instructions from <em>Maxima</em> to <em>gnuplot</em>. Most of the time, this file’s contents therefore are helpful when debugging the problem.</li>
<li>Gnuplot was instructed to use the pngcairo library that provides antialiasing and additional line styles, but it was not compiled to support this possibility. Solution: Uncheck the “Use the cairo terminal for plot” checkbox in the configuration dialog and don’t set <code>wxplot_pngcairo</code> to true from <em>Maxima</em>.</li>
<li>Gnuplot didn’t output a valid <code>.png</code> file.</li>
</ul>
<h2 number="3.5" id="plotting-an-animation-results-in-error-undefined-variable"><span class="header-section-number">3.5</span> Plotting an animation results in “error: undefined variable”</h2>
<p>The value of the slider variable by default is only substituted into the expression that is to be plotted if it is visible there. Using a <code>subst</code> command that substitutes the slider variable into the equation to plot resolves this problem. At the end of section <a href="#embedding-animations-into-the-spreadsheet">Embedding animations into the spreadsheet</a> you can see an example.</p>
<h2 number="3.6" id="i-lost-a-cell-contents-and-undo-doesnt-remember"><span class="header-section-number">3.6</span> I lost a cell contents and undo doesn’t remember</h2>
<p>There are separate undo functions for cell operations and for changes inside of cells so chances are low that this ever happens. If it does there are several methods to recover data:</p>
<ul>
<li><em>wxMaxima</em> actually has two undo features: The global undo buffer that is active if no cell is selected and a per-cell undo buffer that is active if the cursor is inside a cell. It is worth trying to use both undo options in order to see if an old value can still be accessed.</li>
<li>If you still have a way to find out what label <em>Maxima</em> has assigned to the cell just type in the cell’s label and its contents will reappear.</li>
<li>If you don’t: Don’t panic. In the “View” menu there is a way to show a history pane that shows all <em>Maxima</em> commands that have been issued recently.</li>
<li>If nothing else helps <em>Maxima</em> contains a replay feature:</li>
</ul>
<div class="sourceCode" id="cb20"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb20-1"><a href="#cb20-1" aria-hidden="true"></a><span class="fu">playback</span>();</span></code></pre></div>
<h2 number="3.7" id="wxmaxima-starts-up-with-the-message-maxima-process-terminated."><span class="header-section-number">3.7</span> <em>wxMaxima</em> starts up with the message “Maxima process terminated.”</h2>
<p>One possible reason is that <em>Maxima</em> cannot be found in the location that is set in the “Maxima” tab of <em>wxMaxima</em>’s configuration dialog and therefore won’t run at all. Setting the path to a working <em>Maxima</em> binary should fix this problem.</p>
<h2 number="3.8" id="maxima-is-forever-calculating-and-not-responding-to-input"><span class="header-section-number">3.8</span> Maxima is forever calculating and not responding to input</h2>
<p>It is theoretically possible that <em>wxMaxima</em> doesn’t realize that <em>Maxima</em> has finished calculating and therefore never gets informed it can send new data to <em>Maxima</em>. If this is the case “Trigger evaluation” might resynchronize the two programs.</p>
<h2 number="3.9" id="my-sbcl-based-maxima-runs-out-of-memory"><span class="header-section-number">3.9</span> My SBCL-based <em>Maxima</em> runs out of memory</h2>
<p>The Lisp compiler SBCL by default comes with a memory limit that allows it to run even on low-end computers. When compiling a big software package like Lapack or dealing with extremely big lists or equations this limit might be too low. In order to extend the limits SBCL can be provided with the command line parameter <code>--dynamic-space-size</code> that tells SBCL how many megabytes it should reserve. A 32bit Windows-SBCL can reserve up to 999 Megabytes. A 64-bit SBCL version running on Windows can be instructed to use more than the about 1280 Megabytes compiling Lapack needs.</p>
<p>One way to provide <em>Maxima</em> (and thus SBCL) with command line parameters is the “Additional parameters for Maxima” field of <em>wxMaxima</em>’s configuration dialogue.</p>
<div class="figure">
<img src="./sbclMemory.png" id="img_sbclMemory" alt="" />
<p class="caption">sbcl memory</p>
</div>
<h2 number="3.10" id="input-sometimes-is-sluggishignoring-keys-on-ubuntu"><span class="header-section-number">3.10</span> Input sometimes is sluggish/ignoring keys on Ubuntu</h2>
<p>Installing the package <code>ibus-gtk</code> should resolve this issue. See (<a href="https://bugs.launchpad.net/ubuntu/+source/wxwidgets3.0/+bug/1421558">https://bugs.launchpad.net/ubuntu/+source/wxwidgets3.0/+bug/1421558</a>) for details.</p>
<h2 number="3.11" id="wxmaxima-halts-when-maxima-processes-greek-characters-or-umlauts"><span class="header-section-number">3.11</span> <em>wxMaxima</em> halts when <em>Maxima</em> processes Greek characters or Umlauts</h2>
<p>If your <em>Maxima</em> is based on SBCL the following lines have to be added to your <code>.sbclrc</code>:</p>
<div class="sourceCode" id="cb21"><pre class="sourceCode commonlisp"><code class="sourceCode commonlisp"><span id="cb21-1"><a href="#cb21-1" aria-hidden="true"></a>(<span class="kw">setf</span> sb-impl::*default-external-format* :utf<span class="dv">-8</span>)</span></code></pre></div>
<p>The folder this file has to be placed in is system- and installation-specific. But any SBCL-based <em>Maxima</em> that already has evaluated a cell in the current session will happily tell where it can be found after getting the following command:</p>
<pre><code>:lisp (sb-impl::userinit-pathname)</code></pre>
<h2 number="3.12" id="plotting-1"><span class="header-section-number">3.12</span> Plotting</h2>
<h3 number="3.12.1" id="can-i-make-wxmaxima-output-both-image-files-and-embedded-plots-at-once"><span class="header-section-number">3.12.1</span> Can I make <em>wxMaxima</em> output both image files and embedded plots at once?</h3>
<p>The worksheet embeds .png files. <em>wxMaxima</em> allows the user to specify where they should be generated:</p>
<div class="sourceCode" id="cb23"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb23-1"><a href="#cb23-1" aria-hidden="true"></a><span class="cn">wxdraw2d</span>(</span>
<span id="cb23-2"><a href="#cb23-2" aria-hidden="true"></a> <span class="cn">file_name</span>=<span class="st">"test"</span>,</span>
<span id="cb23-3"><a href="#cb23-3" aria-hidden="true"></a> <span class="cn">explicit</span>(<span class="fu">sin</span>(<span class="cn">x</span>),<span class="cn">x</span>,<span class="dv">1</span>,<span class="dv">10</span>)</span>
<span id="cb23-4"><a href="#cb23-4" aria-hidden="true"></a>);</span></code></pre></div>
<p>If a different format is to be used it is easier to generate the images and then to import them into the worksheet again:</p>
<div class="sourceCode" id="cb24"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb24-1"><a href="#cb24-1" aria-hidden="true"></a><span class="fu">load</span>(<span class="st">"draw"</span>);</span>
<span id="cb24-2"><a href="#cb24-2" aria-hidden="true"></a><span class="cn">pngdraw</span>(<span class="cn">name</span>,[<span class="cn">contents</span>]):=</span>
<span id="cb24-3"><a href="#cb24-3" aria-hidden="true"></a>(</span>
<span id="cb24-4"><a href="#cb24-4" aria-hidden="true"></a> <span class="fu">draw</span>(</span>
<span id="cb24-5"><a href="#cb24-5" aria-hidden="true"></a> <span class="fu">append</span>(</span>
<span id="cb24-6"><a href="#cb24-6" aria-hidden="true"></a> [</span>
<span id="cb24-7"><a href="#cb24-7" aria-hidden="true"></a> <span class="cn">terminal</span>=<span class="cn">pngcairo</span>,</span>
<span id="cb24-8"><a href="#cb24-8" aria-hidden="true"></a> <span class="cn">dimensions</span>=<span class="cn">wxplot_size</span>,</span>
<span id="cb24-9"><a href="#cb24-9" aria-hidden="true"></a> <span class="cn">file_name</span>=<span class="cn">name</span></span>
<span id="cb24-10"><a href="#cb24-10" aria-hidden="true"></a> ],</span>
<span id="cb24-11"><a href="#cb24-11" aria-hidden="true"></a> <span class="cn">contents</span></span>
<span id="cb24-12"><a href="#cb24-12" aria-hidden="true"></a> )</span>
<span id="cb24-13"><a href="#cb24-13" aria-hidden="true"></a> ),</span>
<span id="cb24-14"><a href="#cb24-14" aria-hidden="true"></a> <span class="cn">show_image</span>(<span class="fu">printf</span>(<span class="kw">false</span>,<span class="st">"~a.png"</span>,<span class="cn">name</span>))</span>
<span id="cb24-15"><a href="#cb24-15" aria-hidden="true"></a>);</span>
<span id="cb24-16"><a href="#cb24-16" aria-hidden="true"></a><span class="cn">pngdraw2d</span>(<span class="cn">name</span>,[<span class="cn">contents</span>]):=</span>
<span id="cb24-17"><a href="#cb24-17" aria-hidden="true"></a> <span class="cn">pngdraw</span>(<span class="cn">name</span>,<span class="cn">gr2d</span>(<span class="cn">contents</span>));</span>
<span id="cb24-18"><a href="#cb24-18" aria-hidden="true"></a></span>
<span id="cb24-19"><a href="#cb24-19" aria-hidden="true"></a><span class="cn">pngdraw2d</span>(<span class="st">"Test"</span>,</span>
<span id="cb24-20"><a href="#cb24-20" aria-hidden="true"></a> <span class="cn">explicit</span>(<span class="fu">sin</span>(<span class="cn">x</span>),<span class="cn">x</span>,<span class="dv">1</span>,<span class="dv">10</span>)</span>
<span id="cb24-21"><a href="#cb24-21" aria-hidden="true"></a>);</span></code></pre></div>
<h3 number="3.12.2" id="can-i-set-the-aspect-ratio-of-a-plot"><span class="header-section-number">3.12.2</span> Can I set the aspect ratio of a plot?</h3>
<p>Not directly using <em>Maxima</em>. But there are gnuplot commands for it:</p>
<div class="sourceCode" id="cb25"><pre class="sourceCode maxima"><code class="sourceCode maxima"><span id="cb25-1"><a href="#cb25-1" aria-hidden="true"></a><span class="cn">wxdraw2d</span>(</span>
<span id="cb25-2"><a href="#cb25-2" aria-hidden="true"></a> <span class="cn">proportional_axis</span>=<span class="cn">xy</span>,</span>
<span id="cb25-3"><a href="#cb25-3" aria-hidden="true"></a> <span class="cn">explicit</span>(<span class="fu">sin</span>(<span class="cn">x</span>),<span class="cn">x</span>,<span class="dv">1</span>,<span class="dv">10</span>)</span>
<span id="cb25-4"><a href="#cb25-4" aria-hidden="true"></a>),<span class="cn">wxplot_size</span>=[<span class="dv">1000</span>,<span class="dv">1000</span>];</span></code></pre></div>
<hr />
<h1 number="4" id="faq"><span class="header-section-number">4</span> FAQ</h1>
<h2 number="4.1" id="is-there-a-way-to-make-more-text-fit-on-a-latex-page"><span class="header-section-number">4.1</span> Is there a way to make more text fit on a LaTeX page?</h2>
<p>There is: Just add the following lines to the LaTeX preamble (for example by using the respective field in the config dialogue (“Export”->“Additional lines for the TeX preamble”):</p>
<div class="sourceCode" id="cb26"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb26-1"><a href="#cb26-1" aria-hidden="true"></a><span class="bu">\usepackage</span>[left=1cm,right=1cm,top=1cm,bottom=1cm]{<span class="ex">geometry</span>}</span></code></pre></div>
<h2 number="4.2" id="is-there-a-dark-mode"><span class="header-section-number">4.2</span> Is there a dark mode?</h2>
<p>If wxWidgets is new enough <em>wxMaxima</em> will automatically be in dark mode if the rest of the operating system is. The worksheet itself is by default equipped with a bright background. But it can be configured otherwise. Alternatively there is a <code>View/Invert worksheet brightness</code> menu entry that allows to quickly convert the worksheet from dark to bright and vice versa.</p>
<h2 number="4.3" id="wxmaxima-sometimes-hangs-for-a-several-seconds-once-in-the-first-minute"><span class="header-section-number">4.3</span> <em>wxMaxima</em> sometimes hangs for a several seconds once in the first minute</h2>
<p><em>wxMaxima</em> delegates some big tasks like parsing <em>Maxima</em>’s >1000-page-manual to background tasks, which normally goes totally unnoticed. In the moment the result of such a task is needed, though, it is possible that <em>wxMaxima</em> needs to wait a couple of seconds before it can continue its work.</p>
<hr />
<h1 number="5" id="command-line-arguments"><span class="header-section-number">5</span> Command-line arguments</h1>
<p>Most operating systems provide less complicated ways of starting programs than the command line so this possibility is only rarely used. <em>wxMaxima</em> still provides some command line switches, though.</p>
<ul>
<li><code>-v</code> or <code>--version</code>: Output the version information</li>
<li><code>-h</code> or <code>--help</code>: Output a short help text</li>
<li><code>-o</code> or <code>--open=<str></code>: Open the filename given as argument to this command-line switch</li>
<li><code>-e</code> or <code>--eval</code>: Evaluate the file after opening it.</li>
<li><code>-b</code> or <code>--batch</code>: If the command-line opens a file all cells in this file are evaluated and the file is saved afterwards. This is for example useful if the session described in the file makes <em>Maxima</em> generate output files. Batch-processing will be stopped if <em>wxMaxima</em> detects that <em>Maxima</em> has output an error and will pause if <em>Maxima</em> has a question: Mathematics is somewhat interactive by nature so a completely interaction-free batch processing cannot always be guaranteed.</li>
<li><code>--logtostdout</code>: Log all “debug messages” sidebar messages to stderr, too.</li>
<li><code>--pipe</code>: Pipe messages from Maxima to stdout.</li>
<li><code>--exit-on-error</code>: Close the program on any maxima error.</li>
<li><code>-f</code> or <code>--ini=<str></code>: Use the init file that was given as argument to this command-line switch</li>
<li><code>-u</code>, <code>--use-version=<str></code>: Use maxima version <code><str></code>.</li>
<li><code>-l</code>, <code>--lisp=<str></code>: Use a Maxima compiled with Lisp compiler <code><str></code>.</li>
<li><code>-X</code>, <code>--extra-args=<str></code>: Allows to specify extra Maxima arguments</li>
<li><code>-m</code> or <code>--maxima=<str></code>: allows to specify the location of the <em>maxima</em> binary</li>
<li><code>--enableipc</code>: Lets Maxima control wxMaxima via interprocess communications. Use this option with care.</li>
</ul>
<p>Instead of a minus some operating systems might use a dash in front of the command-line switches.</p>
</body>
</html>
|