1msgid ""
2msgstr ""
3"Project-Id-Version: wxmaxima\n"
4"Report-Msgid-Bugs-To: \n"
5"POT-Creation-Date: 2020-04-18 09:08+0200\n"
6"PO-Revision-Date: 2016-02-22 16:12-0500\n"
7"Last-Translator: kahkonen <mika.m.kahkonen@gmail.com>\n"
8"Language-Team: Finnish\n"
9"Language: fi\n"
10"MIME-Version: 1.0\n"
11"Content-Type: text/plain; charset=UTF-8\n"
12"Content-Transfer-Encoding: 8bit\n"
13"Plural-Forms: nplurals=2; plural=(n != 1);\n"
14"X-Generator: crowdin.com\n"
15"X-Crowdin-Project: wxmaxima\n"
16"X-Crowdin-Language: fi\n"
17"X-Crowdin-File: fi.po\n"
18
19#. type: Plain text
20#: /home/gunter/src/wxmaxima/info/wxmaxima.md:2
21#, no-wrap
22msgid ""
23"The wxMaxima user manual {-}\n"
24"============================\n"
25msgstr ""
26
27#. type: Plain text
28#: /home/gunter/src/wxmaxima/info/wxmaxima.md:5
29msgid ""
30"wxMaxima is a graphical user interface (GUI) for the _Maxima_ computer "
31"algebra system (CAS). wxMaxima allows one to use all of _Maxima_’s "
32"functions. In addition, it provides convenient wizards for accessing the "
33"most commonly used features. This manual describes some of the features that "
34"make wxMaxima one of the most popular GUIs for _Maxima_."
35msgstr ""
36
37#. type: Plain text
38#: /home/gunter/src/wxmaxima/info/wxmaxima.md:7
39msgid "![wxMaxima logo](./wxMaximaLogo.png){ id=img_wxMaximaLogo }"
40msgstr ""
41
42#. type: Plain text
43#: /home/gunter/src/wxmaxima/info/wxmaxima.md:9
44msgid ""
45"Before we look at the content a few points regarding navigation are in "
46"order. Immediately below is a short table of contents. Clicking on any of "
47"the listed items moves the cursor to the top of the indicated section of the "
48"manual. Clicking on [Contents](#TOC) here the short table of contents moves "
49"the cursor to an extended table of contents. This extended table can be used "
50"to navigate more directly to specific parts of the manual."
51msgstr ""
52
53#. type: Bullet: '* '
54#: /home/gunter/src/wxmaxima/info/wxmaxima.md:11
55msgid "[Introduction](#introduction-to-wxmaxima \"Introduction to wxMaxima\"):"
56msgstr ""
57
58#. type: Plain text
59#: /home/gunter/src/wxmaxima/info/wxmaxima.md:15
60msgid "wxMaxima basics"
61msgstr ""
62
63#. type: Bullet: '* '
64#: /home/gunter/src/wxmaxima/info/wxmaxima.md:17
65msgid "[Extensions](#extensions-to-maxima \"Extensions\"):"
66msgstr ""
67
68#. type: Plain text
69#: /home/gunter/src/wxmaxima/info/wxmaxima.md:21
70msgid "The commands wxMaxima adds to _Maxima_"
71msgstr ""
72
73#. type: Bullet: '* '
74#: /home/gunter/src/wxmaxima/info/wxmaxima.md:23
75msgid "[Troubleshooting](#troubleshooting \"Troubleshooting\"):"
76msgstr ""
77
78#. type: Plain text
79#: /home/gunter/src/wxmaxima/info/wxmaxima.md:27
80msgid "What to do if wxMaxima does not work as expected"
81msgstr ""
82
83#. type: Bullet: '* '
84#: /home/gunter/src/wxmaxima/info/wxmaxima.md:29
85msgid "[FAQ](#faq \"FAQ\"):"
86msgstr ""
87
88#. type: Plain text
89#: /home/gunter/src/wxmaxima/info/wxmaxima.md:33
90msgid "Frequently asked questions"
91msgstr ""
92
93#. type: Bullet: '* '
94#: /home/gunter/src/wxmaxima/info/wxmaxima.md:35
95msgid "[CommandLine](#command-line-arguments \"_Maxima_ Command Line\"):"
96msgstr ""
97
98#. type: Plain text
99#: /home/gunter/src/wxmaxima/info/wxmaxima.md:39
100msgid "The command-line arguments wxMaxima supports"
101msgstr ""
102
103#. type: Bullet: '* '
104#: /home/gunter/src/wxmaxima/info/wxmaxima.md:41
105#: /home/gunter/src/wxmaxima/info/wxmaxima.md:348
106#: /home/gunter/src/wxmaxima/info/wxmaxima.md:635
107#: /home/gunter/src/wxmaxima/info/wxmaxima.md:774
108#: /home/gunter/src/wxmaxima/info/wxmaxima.md:794
109msgid "* *"
110msgstr ""
111
112#. type: Plain text
113#: /home/gunter/src/wxmaxima/info/wxmaxima.md:44
114#, no-wrap
115msgid ""
116"Introduction to wxMaxima\n"
117"========================\n"
118msgstr ""
119
120#. type: Plain text
121#: /home/gunter/src/wxmaxima/info/wxmaxima.md:47
122msgid "## _Maxima_ and wxMaxima"
123msgstr ""
124
125#. type: Plain text
126#: /home/gunter/src/wxmaxima/info/wxmaxima.md:49
127msgid ""
128"In the open-source domain big systems are normally split into smaller "
129"projects that are easier to handle for small groups of developers. For "
130"example a CD burner program will consist of a command-line tool that "
131"actually burns the CD and a graphical user interface that allows users to "
132"implement it without having to learn about all the command line switches and "
133"in fact without using the command line at all. One advantage of this "
134"approach is that the developing work that was invested into the command-line "
135"program can be shared by many programs: The same CD-burner command-line "
136"program can be used as a “send-to-CD”-plug-in for a file manager "
137"application, for the “burn to CD” function of a music player and as the CD "
138"writer for a DVD backup tool. Another advantage is that splitting one big "
139"task into smaller parts allows the developers to provide several user "
140"interfaces for the same program."
141msgstr ""
142
143#. type: Plain text
144#: /home/gunter/src/wxmaxima/info/wxmaxima.md:51
145msgid ""
146"A computer algebra system (CAS) like _Maxima_ fits into this framework. A "
147"CAS can provide the logic behind an arbitrary precision calculator "
148"application or it can do automatic transforms of formulas in the background "
149"of a bigger system (e.g., [Sage](https://www.sagemath.org/)). Alternatively, "
150"it can be used directly as a free-standing system. _Maxima_ can be accessed "
151"via a command line. Often, however, an interface like wxMaxima proves a more "
152"efficient way to access the software, especially for newcomers."
153msgstr ""
154
155#. type: Plain text
156#: /home/gunter/src/wxmaxima/info/wxmaxima.md:53
157msgid "### _Maxima_"
158msgstr ""
159
160#. type: Plain text
161#: /home/gunter/src/wxmaxima/info/wxmaxima.md:55
162msgid ""
163"_Maxima_ is a full-featured computer algebra system (CAS). A CAS is a "
164"program that can solve mathematical problems by rearranging formulas and "
165"finding a formula that solves the problem as opposed to just outputting the "
166"numeric value of the result. In other words, _Maxima_ can serve as a "
167"calculator that gives numerical representations of variables, and it can "
168"also provide analytical solutions. Furthermore, it offers a range of "
169"numerical methods of analysis for equations or systems of equations that "
170"cannot be solved analytically."
171msgstr ""
172
173#. type: Plain text
174#: /home/gunter/src/wxmaxima/info/wxmaxima.md:57
175msgid ""
176"![Maxima screenshot](./maxima_screenshot.png){ id=img_maxima_screenshot }"
177msgstr ""
178
179#. type: Plain text
180#: /home/gunter/src/wxmaxima/info/wxmaxima.md:59
181msgid ""
182"Extensive documentation for _Maxima_ is [available in the internet](http://"
183"maxima.sourceforge.net/documentation.html). Part of this documentation is "
184"also available in wxMaxima’s help menu. Pressing the Help key (on most "
185"systems that would be the F1 key) causes wxMaxima’s context-sensitive help "
186"feature will automatically jump to _Maxima_’s manual page for the command at "
187"the cursor."
188msgstr ""
189
190#. type: Plain text
191#: /home/gunter/src/wxmaxima/info/wxmaxima.md:61
192msgid "### wxMaxima"
193msgstr ""
194
195#. type: Plain text
196#: /home/gunter/src/wxmaxima/info/wxmaxima.md:63
197msgid ""
198"wxMaxima is a graphical user interface that provides the full functionality "
199"and flexibility of _Maxima_. wxMaxima offers users a graphical display and "
200"many features that make working with _Maxima_ easier. For example wxMaxima "
201"allows one to export any cell’s contents (or, if that is needed, any part of "
202"a formula, as well) as text, as LaTeX or as MathML specification at a simple "
203"right-click. Indeed, an entire workbook can be exported, either as a HTML "
204"file or as a LaTeX file. Documentation for _wxMaxima_, including workbooks "
205"to illustrate aspects of its use, is online at the wxMaxima [help site]"
206"(https://wxMaxima-developers.github.io/wxmaxima/help.html), as well as via "
207"the help menu."
208msgstr ""
209
210#. type: Plain text
211#: /home/gunter/src/wxmaxima/info/wxmaxima.md:65
212msgid "![wxMaxima window](./wxMaximaWindow.png){ id=img_wxMaximaWindow }"
213msgstr ""
214
215#. type: Plain text
216#: /home/gunter/src/wxmaxima/info/wxmaxima.md:67
217msgid ""
218"The calculations that are entered in _wxMaxima_ are performed by the "
219"_Maxima_ command-line tool in the background."
220msgstr ""
221
222#. type: Plain text
223#: /home/gunter/src/wxmaxima/info/wxmaxima.md:70
224msgid "## Workbook basics"
225msgstr ""
226
227#. type: Plain text
228#: /home/gunter/src/wxmaxima/info/wxmaxima.md:72
229msgid ""
230"Much of wxMaxima is self-explaining, but some details require attention. "
231"[This site](https://wxMaxima-developers.github.io/wxmaxima/help.html) "
232"contains a number of workbooks that address various aspects of wxMaxima. "
233"Working through some of these (particularly the \"10 minute (wx)Maxima "
234"tutorial\") will increase one’s familiarity with both the content of "
235"_Maxima_ and the use of wxMaxima to interact with _Maxima_. This manual "
236"concentrates on describing aspects of wxMaxima that are not likely to be "
237"self-evident and that might not be covered in the online material."
238msgstr ""
239
240#. type: Plain text
241#: /home/gunter/src/wxmaxima/info/wxmaxima.md:74
242msgid "### The workbook approach"
243msgstr ""
244
245#. type: Plain text
246#: /home/gunter/src/wxmaxima/info/wxmaxima.md:76
247msgid ""
248"One of the very few things that are not standard in wxMaxima is that it "
249"organizes the data for _Maxima_ into cells that are evaluated (which means: "
250"sent to _Maxima_) only when the user requests this. When a cell is "
251"evaluated, all commands in that cell, and only that cell, are evaluated as a "
252"batch. (The preceding statement is not quite accurate: One can select a set "
253"of adjacent cells and evaluate them together. Also, one can instruct "
254"_Maxima_ to evaluate all cells in a workbook in one pass.) _wxMaxima_'s "
255"approach to submitting commands for execution might feel unfamiliar at the "
256"first sight. It does, however, drastically ease work with big documents "
257"(where the user certainly does not want every small change to automatically "
258"to trigger a full re-evaluation of the whole document). Also, this approach "
259"is very handy for debugging."
260msgstr ""
261
262#. type: Plain text
263#: /home/gunter/src/wxmaxima/info/wxmaxima.md:78
264msgid ""
265"If text is typed into _wxMaxima_ it automatically creates a new worksheet "
266"cell. The type of this cell can be selected in the toolbar. If a code cell "
267"is created the cell can be sent to _maxima_, which causes the result of the "
268"calculation to be displayed below the code. A pair of such commands is shown "
269"below."
270msgstr ""
271
272#. type: Plain text
273#: /home/gunter/src/wxmaxima/info/wxmaxima.md:80
274msgid "![Input/output cell](./InputCell.png){ id=img_InputCell }"
275msgstr ""
276
277#. type: Plain text
278#: /home/gunter/src/wxmaxima/info/wxmaxima.md:82
279msgid ""
280"On evaluation of an input cell's contents the input cell _Maxima_ assigns a "
281"label to the input (by default shown in red and recognizable by the `%i`) by "
282"which it can be referenced later in the _wxMaxima_ session. The output that "
283"_Maxima_ generates also gets a label that begins with `%o` and by default is "
284"hidden, except if the user assigns the output a name. In this case by "
285"default the user-defined label is displayed. The `%o`\\-style label _Maxima_ "
286"auto-generates will also be accessible, though."
287msgstr ""
288
289#. type: Plain text
290#: /home/gunter/src/wxmaxima/info/wxmaxima.md:84
291msgid ""
292"Besides the input cells wxMaxima allows for text cells for documentation, "
293"image cells, title cells, chapter cells and section cells. Every cell has "
294"its own undo buffer so debugging by changing the values of several cells and "
295"then gradually reverting the unneeded changes is rather easy. Furthermore "
296"the worksheet itself has a global undo buffer that can undo cell edits, adds "
297"and deletes."
298msgstr ""
299
300#. type: Plain text
301#: /home/gunter/src/wxmaxima/info/wxmaxima.md:86
302msgid ""
303"The figure below shows different cell types (Title cells, section cells, "
304"subsection cells, text cells, input/output cells and an image cell."
305msgstr ""
306
307#. type: Plain text
308#: /home/gunter/src/wxmaxima/info/wxmaxima.md:88
309msgid ""
310"![Example of different wxMaxima cells](./cell-example.png){ id=img_cell-"
311"example }"
312msgstr ""
313
314#. type: Plain text
315#: /home/gunter/src/wxmaxima/info/wxmaxima.md:91
316msgid "### Cells"
317msgstr ""
318
319#. type: Plain text
320#: /home/gunter/src/wxmaxima/info/wxmaxima.md:93
321msgid ""
322"The worksheet is organized in cells. Each cell can contain other cells or "
323"the following types of content:"
324msgstr ""
325
326#. type: Bullet: '* '
327#: /home/gunter/src/wxmaxima/info/wxmaxima.md:99
328msgid "one or more lines of _Maxima_ input"
329msgstr ""
330
331#. type: Bullet: '* '
332#: /home/gunter/src/wxmaxima/info/wxmaxima.md:99
333msgid "one or more image"
334msgstr ""
335
336#. type: Bullet: '* '
337#: /home/gunter/src/wxmaxima/info/wxmaxima.md:99
338msgid "output of, or a question from, _Maxima_"
339msgstr ""
340
341#. type: Bullet: '* '
342#: /home/gunter/src/wxmaxima/info/wxmaxima.md:99
343msgid "a text block that can for example be used for documentation"
344msgstr ""
345
346#. type: Bullet: '* '
347#: /home/gunter/src/wxmaxima/info/wxmaxima.md:99
348msgid "a title, section or a subsection."
349msgstr ""
350
351#. type: Plain text
352#: /home/gunter/src/wxmaxima/info/wxmaxima.md:101
353msgid ""
354"The default behavior of _wxMaxima_ when text is entered is to automatically "
355"create a math cell. Cells of other types can be created using the Cell menu, "
356"using the hot keys shown in the menu or using the drop-down list in the "
357"toolbar."
358msgstr ""
359
360#. type: Plain text
361#: /home/gunter/src/wxmaxima/info/wxmaxima.md:103
362msgid "### Horizontal and vertical cursors"
363msgstr ""
364
365#. type: Plain text
366#: /home/gunter/src/wxmaxima/info/wxmaxima.md:105
367msgid ""
368"If the user tries to select a complete sentence a word processor will try to "
369"extend the selection to automatically begin and end with a word boundary. "
370"Likewise _wxMaxima_ if more than one cell is selected will extend the "
371"selection to whole cells."
372msgstr ""
373
374#. type: Plain text
375#: /home/gunter/src/wxmaxima/info/wxmaxima.md:107
376msgid ""
377"What isn't standard is that _wxMaxima_ provides drag-and-drop flexibility by "
378"defining two types of cursors. _wxMaxima_ will switch between them "
379"automatically when needed:"
380msgstr ""
381
382#. type: Bullet: '* '
383#: /home/gunter/src/wxmaxima/info/wxmaxima.md:110
384msgid ""
385"A horizontal cursor that is able to select any number of whole cells. This "
386"cursor is activated by moving the cursor between two cells or by clicking on "
387"a space between two cells. To select a set of adjacent cells, click in the "
388"bracket at the left of the top cell (but not inside the triangle) and then "
389"drag the cursor so that this cell and the next cell (or range of cells) is "
390"highlighted. Then use <kbd>CTRL</kbd>+<kbd>ENTER</kbd> or <kbd>SHIFT</kbd>"
391"+<kbd>ENTER</kbd> to execute the highlighted cells."
392msgstr ""
393
394#. type: Bullet: '* '
395#: /home/gunter/src/wxmaxima/info/wxmaxima.md:110
396msgid ""
397"A vertical cursor that works inside a cell. This cursor is activated by "
398"moving the cursor inside a cell using the mouse pointer or the cursor keys "
399"and works much like the cursor in a text editor."
400msgstr ""
401
402#. type: Plain text
403#: /home/gunter/src/wxmaxima/info/wxmaxima.md:112
404msgid "### Command autocompletion"
405msgstr ""
406
407#. type: Plain text
408#: /home/gunter/src/wxmaxima/info/wxmaxima.md:114
409msgid ""
410"_wxMaxima_ contains an autocompletion feature that is triggered via the menu "
411"(Cell/Complete Word) or alternatively by pressing the key combination "
412"<kbd>CTRL</kbd>+<kbd>SPACE</kbd>. The autocompletion is context-sensitive. "
413"For example if activated within an unit specification for ezUnits it will "
414"offer a list of applicable units."
415msgstr ""
416
417#. type: Plain text
418#: /home/gunter/src/wxmaxima/info/wxmaxima.md:116
419msgid "![ezUnits](./ezUnits.png){ id=img_ezUnits }"
420msgstr ""
421
422#. type: Plain text
423#: /home/gunter/src/wxmaxima/info/wxmaxima.md:118
424msgid ""
425"Besides completing a file name, an unit name or the current command’s or "
426"variable’s name the autocompletion is able to show a template for most of "
427"the commands indicating the type (and meaning) of the parameters this "
428"program expects. To activate this feature press <kbd>SHIFT</kbd>+<kbd>CTRL</"
429"kbd>+<kbd>SPACE</kbd> or select the respective menu item (Cell/Show "
430"Template)."
431msgstr ""
432
433#. type: Plain text
434#: /home/gunter/src/wxmaxima/info/wxmaxima.md:120
435msgid "#### Greek characters"
436msgstr ""
437
438#. type: Plain text
439#: /home/gunter/src/wxmaxima/info/wxmaxima.md:122
440msgid ""
441"Computers traditionally store characters in 8-bit values. This allows for a "
442"maximum of 256 different characters. All letters, numbers, and control "
443"symbols (end of transmission, end of string, lines and edges for drawing "
444"rectangles for menus _etc_.) of nearly any given language can fit within "
445"that limit."
446msgstr ""
447
448#. type: Plain text
449#: /home/gunter/src/wxmaxima/info/wxmaxima.md:124
450msgid ""
451"For most countries the codepage of 256 characters that has been chosen does "
452"not include things like Greek letters, though, that are frequently used in "
453"mathematics. To overcome this type of limitation Unicode has been invented: "
454"An encoding that makes english text work like normal, but to use characters "
455"whose keycode are more than 8 bits long."
456msgstr ""
457
458#. type: Plain text
459#: /home/gunter/src/wxmaxima/info/wxmaxima.md:126
460msgid ""
461"_Maxima_ allows for unicode characters if it was compiled using a Lisp "
462"compiler that either supports lisp or that doesn't care about the font "
463"encoding. As at least one of this is likely to be true _wxMaxima_ provides a "
464"method of entering Greek characters using the keyboard:"
465msgstr ""
466
467#. type: Bullet: '* '
468#: /home/gunter/src/wxmaxima/info/wxmaxima.md:129
469msgid ""
470"A greek letter can be entered by pressing the <kbd>ESC</kbd> key and then "
471"starting to type the greek character's name."
472msgstr ""
473
474#. type: Bullet: '* '
475#: /home/gunter/src/wxmaxima/info/wxmaxima.md:129
476msgid ""
477"Alternatively it can be entered by pressing <kbd>ESC</kbd>, one letter and "
478"<kbd>ESC</kbd> again. In this case the following letters are supported:"
479msgstr ""
480
481#. type: Plain text
482#: /home/gunter/src/wxmaxima/info/wxmaxima.md:148
483#, no-wrap
484msgid ""
485"~~~~\n"
486"a alpha    i iota      r rho\n"
487"b beta     k kappa     s sigma\n"
488"g gamma    l lambda    t tau\n"
489"d delta    m mu        u upsilon\n"
490"e epsilon  n nu        f phi\n"
491"z zeta     x xi        c chi\n"
492"h eta      om omicron  y psi\n"
493"q theta    p pi        o omega\n"
494"A Alpha    I Iota      R Rho\n"
495"B Beta     K Kappa     S Sigma\n"
496"G Gamma    L Lambda    T Tau\n"
497"D Delta    M Mu        U Upsilon\n"
498"E Epsilon  N Nu        P Phi\n"
499"Z Zeta     X Xi        C Chi\n"
500"H Eta      Om Omicron  Y Psi\n"
501"T Theta    P Pi        O Omega\n"
502"~~~~\n"
503msgstr ""
504
505#. type: Plain text
506#: /home/gunter/src/wxmaxima/info/wxmaxima.md:150
507msgid ""
508"The same mechanism also allows to enter some miscellaneous mathematical "
509"symbols:"
510msgstr ""
511
512#. type: Plain text
513#: /home/gunter/src/wxmaxima/info/wxmaxima.md:203
514#, no-wrap
515msgid ""
516"~~~~\n"
517"hbar          planck's constant: a h with a horizontal bar above it\n"
518"Hbar          a H with a horizontal bar above it\n"
519"2             squared\n"
520"3             to the power of three\n"
521"/2            1/2\n"
522"partial       partial sign (the d of dx/dt)\n"
523"integral      integral sign\n"
524"sq            root\n"
525"ii            imaginary\n"
526"ee            element\n"
527"in            in\n"
528"impl,implies  implies\n"
529"inf           infinity\n"
530"empty         empty\n"
531"TB            Big triangle right\n"
532"tb            small triangle right\n"
533"and           and\n"
534"or            or\n"
535"xor           xor\n"
536"nand          nand\n"
537"nor           nor\n"
538"equiv         equivalent\n"
539"not           not\n"
540"union         union\n"
541"inter         intersection\n"
542"subseteq      subset or equal\n"
543"subset        subset\n"
544"notsubseteq   not subset or equal\n"
545"notsubset     not subset\n"
546"approx        approximately\n"
547"propto        proportional to\n"
548"neq,!=,/=\n"
549"or #          not equal to\n"
550"+/- or pm     a plus/minus sign\n"
551"<= or leq     equal or less than\n"
552">= or geq     equal or greater than\n"
553"<< or ll      much less than\n"
554">> or gg      much greater than\n"
555"equiv         equivalent to\n"
556"qed           end of proof\n"
557"nabla         a nabla operator\n"
558"sum           sum sign\n"
559"prod          product sign\n"
560"exists        \"there exists\" sign\n"
561"nexists       \"there is no\" sign\n"
562"parallel      a \"parallel\" sign\n"
563"perp          a \"perpendicular\" sign\n"
564"leadsto       a \"leads to\" sign\n"
565"->            a right arrow\n"
566"-->           a long right arrow\n"
567"~~~~\n"
568msgstr ""
569
570#. type: Plain text
571#: /home/gunter/src/wxmaxima/info/wxmaxima.md:205
572msgid ""
573"If a special symbol isn’t in the list it is possible to input arbitrary "
574"unicode characters by pressing <kbd>ESC</kbd> [number of the character] "
575"<kbd>ESC</kbd>."
576msgstr ""
577
578#. type: Plain text
579#: /home/gunter/src/wxmaxima/info/wxmaxima.md:207
580msgid ""
581"<kbd>ESC</kbd> <kbd>61</kbd> <kbd>ESC</kbd> therefore results in an `a`."
582msgstr ""
583
584#. type: Plain text
585#: /home/gunter/src/wxmaxima/info/wxmaxima.md:209
586msgid ""
587"Please note that most of these symbols (notable exceptions are the logic "
588"symbols) do not have a special meaning in _Maxima_ and therefore will be "
589"interpreted as ordinary characters. If _Maxima_ is compiled using a Lisp "
590"that doesn’t support dealing with Unicode characters they might cause an "
591"error message instead."
592msgstr ""
593
594#. type: Plain text
595#: /home/gunter/src/wxmaxima/info/wxmaxima.md:212
596msgid "### Side Panes"
597msgstr ""
598
599#. type: Plain text
600#: /home/gunter/src/wxmaxima/info/wxmaxima.md:214
601msgid ""
602"Shortcuts to the most important _Maxima_ commands or things like a table of "
603"contents, windows with debug messages or a history of the last issued "
604"commands can be accessed using the side panes. They can be enabled using the "
605"\"View\" menu. They all can be moved to other locations inside or outside "
606"the _wxMaxima_ window. Other useful panes is the one that allows to input "
607"Greek letters using the mouse."
608msgstr ""
609
610#. type: Plain text
611#: /home/gunter/src/wxmaxima/info/wxmaxima.md:216
612msgid "![Example of different side panes](./SidePanes.png){ id=img_SidePanes }"
613msgstr ""
614
615#. type: Plain text
616#: /home/gunter/src/wxmaxima/info/wxmaxima.md:218
617msgid "### MathML output"
618msgstr ""
619
620#. type: Plain text
621#: /home/gunter/src/wxmaxima/info/wxmaxima.md:220
622msgid ""
623"Several word processors and similar programs either recognize MathML input "
624"and automatically insert it as an editable 2D equation - or (like "
625"LibreOffice 5.1) have an equation editor that offers an “import MathML from "
626"clipboard” feature. Others support RTF maths. _wxMaxima_ therefore offers "
627"several entries in the right-click menu."
628msgstr ""
629
630#. type: Plain text
631#: /home/gunter/src/wxmaxima/info/wxmaxima.md:223
632msgid "### Markdown support"
633msgstr ""
634
635#. type: Plain text
636#: /home/gunter/src/wxmaxima/info/wxmaxima.md:225
637msgid ""
638"_wxMaxima_ offers a set of standard markdown conventions that don't collide "
639"with mathematical notation. One of this elements is bullet lists."
640msgstr ""
641
642#. type: Plain text
643#: /home/gunter/src/wxmaxima/info/wxmaxima.md:235
644#, no-wrap
645msgid ""
646"~~~~\n"
647"Ordinary text\n"
648" * One item, indentation level 1\n"
649" * Another item at indentation level 1\n"
650"   * An item at a second indentation level\n"
651"   * A second item at the second indentation level\n"
652" * A third item at the first indentation level\n"
653"Ordinary text\n"
654"~~~~\n"
655msgstr ""
656
657#. type: Plain text
658#: /home/gunter/src/wxmaxima/info/wxmaxima.md:237
659msgid "_wxMaxima_ will recognize text starting with `>` chars as block quotes:"
660msgstr ""
661
662#. type: Plain text
663#: /home/gunter/src/wxmaxima/info/wxmaxima.md:245
664msgid ""
665"~~~~ Ordinary text > quote quote quote quote > quote quote quote quote > "
666"quote quote quote quote Ordinary text ~~~~"
667msgstr ""
668
669#. type: Plain text
670#: /home/gunter/src/wxmaxima/info/wxmaxima.md:247
671msgid ""
672"_wxMaxima_'s TeX and html output will also recognize `=>` and replace it by "
673"the corresponding unicode sign:"
674msgstr ""
675
676#. type: Plain text
677#: /home/gunter/src/wxmaxima/info/wxmaxima.md:251
678msgid "~~~~ cogito => sum.  ~~~~"
679msgstr ""
680
681#. type: Plain text
682#: /home/gunter/src/wxmaxima/info/wxmaxima.md:253
683msgid ""
684"Other symbols the html and TeX export will recognize are `<=` and `>=` for "
685"comparisons, a double-pointed double arrow (`<=>`), single- headed arrows "
686"(`<->`, `->` and `<-`) and `+/-` as the respective sign. For TeX output also "
687"`<<` and `>>` are recognized."
688msgstr ""
689
690#. type: Plain text
691#: /home/gunter/src/wxmaxima/info/wxmaxima.md:255
692msgid "### Hotkeys"
693msgstr ""
694
695#. type: Plain text
696#: /home/gunter/src/wxmaxima/info/wxmaxima.md:257
697msgid ""
698"Most hotkeys can be found in the text of the respective menus. Since they "
699"are actually taken from the menu text and thus can be customized by the "
700"translations of _wxMaxima_ to match the needs of users of the local "
701"keyboard, we do not document them here. A few hotkeys or hotkey aliases, "
702"though, are not documented in the menus:"
703msgstr ""
704
705#. type: Bullet: '* '
706#: /home/gunter/src/wxmaxima/info/wxmaxima.md:261
707msgid ""
708"<kbd>CTRL</kbd>+<kbd>SHIFT</kbd>+<kbd>DELETE</kbd> deletes a complete cell."
709msgstr ""
710
711#. type: Bullet: '* '
712#: /home/gunter/src/wxmaxima/info/wxmaxima.md:261
713msgid ""
714"<kbd>CTRL</kbd>+<kbd>TAB</kbd> or <kbd>CTRL</kbd>+<kbd>SHIFT</kbd>+<kbd>TAB</"
715"kbd> triggers the auto-completion mechanism."
716msgstr ""
717
718#. type: Bullet: '* '
719#: /home/gunter/src/wxmaxima/info/wxmaxima.md:261
720msgid "<kbd>SHIFT</kbd>+<kbd>SPACE</kbd> inserts a non-breaking space."
721msgstr ""
722
723#. type: Plain text
724#: /home/gunter/src/wxmaxima/info/wxmaxima.md:263
725msgid "### Raw TeX in the TeX export"
726msgstr ""
727
728#. type: Plain text
729#: /home/gunter/src/wxmaxima/info/wxmaxima.md:265
730msgid ""
731"If a text cell begins with `TeX:` the TeX export contains the literal text "
732"that follows the `TeX:` marker. Using this feature allows the entry of TeX "
733"markup within the _wxMaxima_ workbook."
734msgstr ""
735
736#. type: Plain text
737#: /home/gunter/src/wxmaxima/info/wxmaxima.md:267
738msgid "## File Formats"
739msgstr ""
740
741#. type: Plain text
742#: /home/gunter/src/wxmaxima/info/wxmaxima.md:269
743msgid ""
744"The material that is developed in a _wxMaxima_ session can be stored for "
745"later use in any of three ways:"
746msgstr ""
747
748#. type: Plain text
749#: /home/gunter/src/wxmaxima/info/wxmaxima.md:272
750msgid "### .mac"
751msgstr ""
752
753#. type: Plain text
754#: /home/gunter/src/wxmaxima/info/wxmaxima.md:274
755msgid ""
756".mac files are ordinary text files that contain _Maxima_ commands. They can "
757"be read using _Maxima_’s read command or _wxMaxima_’s File/Batch File menu "
758"entry."
759msgstr ""
760
761#. type: Plain text
762#: /home/gunter/src/wxmaxima/info/wxmaxima.md:276
763msgid "One Example:"
764msgstr ""
765
766#. type: Plain text
767#: /home/gunter/src/wxmaxima/info/wxmaxima.md:278
768msgid ""
769"A .mac file named Quadratic.mac was created. It consists of two commands: "
770"`f(x) := (x - 5)^2;` and `wxdraw2d( explicit(f(x),x,-5,15))`. The result of "
771"entering that batch file appears below. (Some directory path information is "
772"deleted.)"
773msgstr ""
774
775#. type: Plain text
776#: /home/gunter/src/wxmaxima/info/wxmaxima.md:280
777msgid "![Batch image](./BatchImage.png){ id=img_BatchImage }"
778msgstr ""
779
780#. type: Plain text
781#: /home/gunter/src/wxmaxima/info/wxmaxima.md:282
782#, no-wrap
783msgid "    read(\"test.mac\");\n"
784msgstr ""
785
786#. type: Plain text
787#: /home/gunter/src/wxmaxima/info/wxmaxima.md:284
788msgid ""
789"You can be use `.mac` files for writing own library of macros. But since "
790"they don’t contain enough structural information they cannot be read back as "
791"a _wxMaxima_ session."
792msgstr ""
793
794#. type: Plain text
795#: /home/gunter/src/wxmaxima/info/wxmaxima.md:286
796msgid "### .wxm"
797msgstr ""
798
799#. type: Plain text
800#: /home/gunter/src/wxmaxima/info/wxmaxima.md:288
801msgid ""
802".wxm files contains the worksheet except _Maxima_'s output. On Maxima "
803"versions >5.38 they can be read using _Maxima_'s `load()` function just as ."
804"mac files can be. With this plain-text format it sometimes is unavoidable "
805"that worksheets that use new features are not downwards-compatible with "
806"older versions of _wxMaxima_."
807msgstr ""
808
809#. type: Plain text
810#: /home/gunter/src/wxmaxima/info/wxmaxima.md:290
811msgid "### .wxmx"
812msgstr ""
813
814#. type: Plain text
815#: /home/gunter/src/wxmaxima/info/wxmaxima.md:292
816msgid ""
817"This xml-based file format saves the complete worksheet including things "
818"like the zoom factor and the watchlist. It is the preferred file format."
819msgstr ""
820
821#. type: Plain text
822#: /home/gunter/src/wxmaxima/info/wxmaxima.md:294
823msgid "## Configuration options"
824msgstr ""
825
826#. type: Plain text
827#: /home/gunter/src/wxmaxima/info/wxmaxima.md:296
828msgid ""
829"For some common configuration variables _wxMaxima_ offers two ways of "
830"configuring:"
831msgstr ""
832
833#. type: Bullet: '* '
834#: /home/gunter/src/wxmaxima/info/wxmaxima.md:299
835msgid ""
836"The configuration dialog box below lets you change their default values for "
837"the current and subsequent sessions."
838msgstr ""
839
840#. type: Bullet: '* '
841#: /home/gunter/src/wxmaxima/info/wxmaxima.md:299
842msgid ""
843"Also, the values for most configuration variables can be changed for the "
844"current session only by overwriting their values from the worksheet, as "
845"shown below."
846msgstr ""
847
848#. type: Plain text
849#: /home/gunter/src/wxmaxima/info/wxmaxima.md:301
850msgid ""
851"![wxMaxima configuration 1](./wxMaxima_configuration_001.png)"
852"{ id=img_wxMaxima_configuration_001 }"
853msgstr ""
854
855#. type: Plain text
856#: /home/gunter/src/wxmaxima/info/wxmaxima.md:303
857msgid "### Default animation framerate"
858msgstr ""
859
860#. type: Plain text
861#: /home/gunter/src/wxmaxima/info/wxmaxima.md:305
862msgid ""
863"The animation framerate that is used for new animations is kept in the "
864"variable `wxanimate_framerate`. The initial value this variable will contain "
865"in a new worksheet can be changed using the configuration dialogue."
866msgstr ""
867
868#. type: Plain text
869#: /home/gunter/src/wxmaxima/info/wxmaxima.md:307
870msgid "### Default plot size for new _maxima_ sessions"
871msgstr ""
872
873#. type: Plain text
874#: /home/gunter/src/wxmaxima/info/wxmaxima.md:309
875msgid ""
876"After the next start plots embedded into the worksheet will be created with "
877"this size if the value of `wxplot_size` isn't changed by _maxima_."
878msgstr ""
879
880#. type: Plain text
881#: /home/gunter/src/wxmaxima/info/wxmaxima.md:311
882msgid ""
883"In order to set the plot size of a single graph only use the following "
884"notation can be used that sets a variable’s value for one command only:"
885msgstr ""
886
887#. type: Plain text
888#: /home/gunter/src/wxmaxima/info/wxmaxima.md:313
889#, no-wrap
890msgid "    wxdraw2d( explicit(x^2,x,-5,5)), wxplot_size=[480,480]$\n"
891msgstr ""
892
893#. type: Plain text
894#: /home/gunter/src/wxmaxima/info/wxmaxima.md:315
895msgid "### Use jsMath fonts"
896msgstr ""
897
898#. type: Plain text
899#: /home/gunter/src/wxmaxima/info/wxmaxima.md:317
900msgid ""
901"The style menu allows customization that pertains to the appearance of your "
902"notebook as you work."
903msgstr ""
904
905#. type: Plain text
906#: /home/gunter/src/wxmaxima/info/wxmaxima.md:319
907msgid ""
908"![wxMaxima configuration 2](./wxMaxima_configuration_002.png)"
909"{ id=img_wxMaxima_configuration_002 }"
910msgstr ""
911
912#. type: Plain text
913#: /home/gunter/src/wxmaxima/info/wxmaxima.md:321
914msgid ""
915"It also contains the option to use jsMath fonts. It is a good idea to "
916"install these fonts since they were especially designed for mathematics and "
917"tend to resolve issues that can be caused by broken fonts. If they are not "
918"installed on your computer, the option to activate them will not be "
919"highlighted. The jsMath fonts can be found on [this site](https://www.mpim-"
920"bonn.mpg.de/node/258). The site describes JsMath fonts and provides "
921"installation instructions."
922msgstr ""
923
924#. type: Plain text
925#: /home/gunter/src/wxmaxima/info/wxmaxima.md:324
926msgid "### Match parenthesis in text controls"
927msgstr ""
928
929#. type: Plain text
930#: /home/gunter/src/wxmaxima/info/wxmaxima.md:326
931msgid "This option enables two things:"
932msgstr ""
933
934#. type: Bullet: '* '
935#: /home/gunter/src/wxmaxima/info/wxmaxima.md:329
936msgid ""
937"If an opening parenthesis, bracket or double quote is entered _wxMaxima_ "
938"will insert a closing one after it."
939msgstr ""
940
941#. type: Bullet: '* '
942#: /home/gunter/src/wxmaxima/info/wxmaxima.md:329
943msgid ""
944"If text is selected if any of these keys is pressed the selected text will "
945"be put between the matched signs."
946msgstr ""
947
948#. type: Plain text
949#: /home/gunter/src/wxmaxima/info/wxmaxima.md:331
950msgid "### Don't save the worksheet automatically"
951msgstr ""
952
953#. type: Plain text
954#: /home/gunter/src/wxmaxima/info/wxmaxima.md:333
955msgid ""
956"If this option is set the file the worksheet is in is overwritten only on "
957"request of the user. In case of a crash/power loss/... a recent backup copy "
958"is still made available in the temp directory, though."
959msgstr ""
960
961#. type: Plain text
962#: /home/gunter/src/wxmaxima/info/wxmaxima.md:335
963msgid ""
964"If this option isn't set wxMaxima behaves more like a modern cellphone app:"
965msgstr ""
966
967#. type: Bullet: '* '
968#: /home/gunter/src/wxmaxima/info/wxmaxima.md:338
969msgid "Files are saved automatically on exit"
970msgstr ""
971
972#. type: Bullet: '* '
973#: /home/gunter/src/wxmaxima/info/wxmaxima.md:338
974msgid "And the file will automatically be saved every 3 minutes."
975msgstr ""
976
977#. type: Plain text
978#: /home/gunter/src/wxmaxima/info/wxmaxima.md:340
979msgid "### Where is the configuration saved?"
980msgstr ""
981
982#. type: Plain text
983#: /home/gunter/src/wxmaxima/info/wxmaxima.md:343
984msgid ""
985"If you are using Unix/Linux, the configuration information will be saved in "
986"a file `.wxMaxima` in your homedirectory (if you are using wxWidgets < "
987"3.1.1), or `.config/wxMaxima.conf` ((XDG-Standard) if wxWidgets >= 3.1.1 is "
988"used). You can retrieve the wxWidgets version from the command "
989"`wxbuild_info();` or by using the menu option Help->About. [wxWidgets]"
990"(https://www.wxwidgets.org/) is the cross-plattform GUI library, which is "
991"the base for wxMaxima (therefore the `wx` in the name).  (Since the filename "
992"starts with a dot, `.wxMaxima` or `.config` will be hidden)."
993msgstr ""
994
995#. type: Plain text
996#: /home/gunter/src/wxmaxima/info/wxmaxima.md:345
997msgid ""
998"If you are using Windows, the configuration will be stored in the registry. "
999"You will find the entries for wxMaxima at the following position in the "
1000"registry: `HKEY_CURRENT_USER\\Software\\wxMaxima`"
1001msgstr ""
1002
1003#. type: Plain text
1004#: /home/gunter/src/wxmaxima/info/wxmaxima.md:351
1005#, no-wrap
1006msgid ""
1007"Extensions to _Maxima_\n"
1008"======================\n"
1009msgstr ""
1010
1011#. type: Plain text
1012#: /home/gunter/src/wxmaxima/info/wxmaxima.md:354
1013msgid ""
1014"_wxMaxima_ is primarily a graphical user interface for _Maxima_. As such, "
1015"its main purpose is to pass along commands to _Maxima_ and to report the "
1016"results of executing those commands. In some cases, however, _wxMaxima_ adds "
1017"functionality to _Maxima_. _wxMaxima_’s ability to generate reports by "
1018"exporting a workbook’s contents to HTML and LaTeX files has been mentioned. "
1019"This section considers some ways that _wxMaxima_ enhances the inclusion of "
1020"graphics into a session. described here."
1021msgstr ""
1022
1023#. type: Plain text
1024#: /home/gunter/src/wxmaxima/info/wxmaxima.md:356
1025msgid "## Subscripted variables"
1026msgstr ""
1027
1028#. type: Plain text
1029#: /home/gunter/src/wxmaxima/info/wxmaxima.md:358
1030msgid ""
1031"if `wxsubscripts` is set to true variable names of the format `x_y` are "
1032"displayed using a subscript if"
1033msgstr ""
1034
1035#. type: Bullet: '* '
1036#: /home/gunter/src/wxmaxima/info/wxmaxima.md:361
1037msgid "`y` is a single letter"
1038msgstr ""
1039
1040#. type: Bullet: '* '
1041#: /home/gunter/src/wxmaxima/info/wxmaxima.md:361
1042msgid "`y` is an integer"
1043msgstr ""
1044
1045#. type: Plain text
1046#: /home/gunter/src/wxmaxima/info/wxmaxima.md:363
1047msgid ""
1048"If the variable name doesn’t match these requirements it can still be "
1049"declared as \"to be subscripted\" using the command "
1050"`wxdeclare_subscript(variable_name);` or "
1051"`wxdeclare_subscript([variable_name1,variable_name2,...]);` Declaring a "
1052"variable as subscripted can be reverted using the following command: "
1053"`wxdeclare_subscript(variable_name,false);`"
1054msgstr ""
1055
1056#. type: Plain text
1057#: /home/gunter/src/wxmaxima/info/wxmaxima.md:365
1058msgid "## User feedback in the statusbar"
1059msgstr ""
1060
1061#. type: Plain text
1062#: /home/gunter/src/wxmaxima/info/wxmaxima.md:367
1063msgid ""
1064"Long-running commands can provide user-feedback in the status bar. This user "
1065"feedback is replaced by any new feedback that is placed there (allowing to "
1066"use it as a progress indicator) and is deleted as soon as the current "
1067"command sent to _maxima_ is finished. It is safe to use `wxstatusbar()` even "
1068"in libraries that might be used with plain _Maxima_ (as opposed to "
1069"_wxMaxima_): If _wxMaxima_ isn't present the `wxstatusbar()` command will "
1070"just be left unevaluated."
1071msgstr ""
1072
1073#. type: Plain text
1074#: /home/gunter/src/wxmaxima/info/wxmaxima.md:376
1075#, no-wrap
1076msgid ""
1077"    for i:1 thru 10 do (\n"
1078"        /* Tell the user how far we got */\n"
1079"        wxstatusbar(concat(\"Pass \",i)),\n"
1080"        /* (sleep n) is a Lisp function, which can be used */\n"
1081"        /* with the character \"?\" before. It delays the */\n"
1082"        /* program execution (here: for 3 seconds) */\n"
1083"        ?sleep(3)\n"
1084"    )$\n"
1085msgstr ""
1086
1087#. type: Plain text
1088#: /home/gunter/src/wxmaxima/info/wxmaxima.md:378
1089#: /home/gunter/src/wxmaxima/info/wxmaxima.md:726
1090msgid "## Plotting"
1091msgstr ""
1092
1093#. type: Plain text
1094#: /home/gunter/src/wxmaxima/info/wxmaxima.md:380
1095msgid ""
1096"Plotting (having fundamentally to do with graphics) is a place where a "
1097"graphical user interface will have to provide some extensions to the "
1098"original program."
1099msgstr ""
1100
1101#. type: Plain text
1102#: /home/gunter/src/wxmaxima/info/wxmaxima.md:382
1103msgid "### Embedding a plot into the work sheet"
1104msgstr ""
1105
1106#. type: Plain text
1107#: /home/gunter/src/wxmaxima/info/wxmaxima.md:384
1108msgid ""
1109"_Maxima_ normally instructs the external program gnuplot to open a separate "
1110"window for every diagram it creates. Since many times it is convenient to "
1111"embed graphs into the work sheet instead _wxMaxima_ provides its own set of "
1112"plot functions that don’t differ from the corresponding _maxima_ functions "
1113"save in their name: They are all prefixed by a “wx”. For example `wxplot2d` "
1114"corresponds to `plot2d`, `wxplot3d` corresponds to `plot3d`, `wxdraw` "
1115"corresponds to `draw` and `wxhistogram` corresponds to `histogram`."
1116msgstr ""
1117
1118#. type: Plain text
1119#: /home/gunter/src/wxmaxima/info/wxmaxima.md:386
1120msgid "### Making embedded plots bigger or smaller"
1121msgstr ""
1122
1123#. type: Plain text
1124#: /home/gunter/src/wxmaxima/info/wxmaxima.md:388
1125msgid ""
1126"As noted above, the configure dialog provides a way to change the default "
1127"size plots are created with which sets the starting value of `wxplot_size`. "
1128"The plotting routines of _wxMaxima_ respect this variable that specifies the "
1129"size of a plot in pixels. It can always be queried or used to set the size "
1130"of the following plots:"
1131msgstr ""
1132
1133#. type: Plain text
1134#: /home/gunter/src/wxmaxima/info/wxmaxima.md:396
1135#, no-wrap
1136msgid ""
1137"    wxplot_size:[1200,800]$\n"
1138"    wxdraw2d(\n"
1139"        explicit(\n"
1140"            sin(x),\n"
1141"            x,1,10\n"
1142"        )\n"
1143"    )$\n"
1144msgstr ""
1145
1146#. type: Plain text
1147#: /home/gunter/src/wxmaxima/info/wxmaxima.md:398
1148msgid ""
1149"If the size of only one plot is to be changed _Maxima_ provides a canonical "
1150"way to change an attribute only for the current cell."
1151msgstr ""
1152
1153#. type: Plain text
1154#: /home/gunter/src/wxmaxima/info/wxmaxima.md:405
1155#, no-wrap
1156msgid ""
1157"     wxdraw2d(\n"
1158"        explicit(\n"
1159"            sin(x),\n"
1160"            x,1,10\n"
1161"        )\n"
1162"     ),wxplot_size=[1600,800]$\n"
1163msgstr ""
1164
1165#. type: Plain text
1166#: /home/gunter/src/wxmaxima/info/wxmaxima.md:408
1167msgid "### Better quality plots"
1168msgstr ""
1169
1170#. type: Plain text
1171#: /home/gunter/src/wxmaxima/info/wxmaxima.md:410
1172msgid ""
1173"Gnuplot doesn’t seem to provide a portable way of determining whether it "
1174"supports the high-quality bitmap output the cairo library provides. On "
1175"systems where gnuplot is compiled to use this library the pngcairo option "
1176"from the configuration menu (that can be overridden by the variable "
1177"`wxplot_pngcairo`) enables support for antialiasing and additional line "
1178"styles. If `wxplot_pngcairo` is set without gnuplot supporting this the "
1179"result will be error messages instead of graphics."
1180msgstr ""
1181
1182#. type: Plain text
1183#: /home/gunter/src/wxmaxima/info/wxmaxima.md:412
1184msgid "### Opening embedded plots in interactive gnuplot windows"
1185msgstr ""
1186
1187#. type: Plain text
1188#: /home/gunter/src/wxmaxima/info/wxmaxima.md:414
1189msgid ""
1190"If a plot was generated using the `wxdraw`-type commands (`wxplot2d` and "
1191"`wxplot3d` isn't supported by this feature) and the file size of the "
1192"underlying gnuplot project isn't way too high _wxMaxima_ offers a right-"
1193"click menu that allows to open the plot in an interactive gnuplot window."
1194msgstr ""
1195
1196#. type: Plain text
1197#: /home/gunter/src/wxmaxima/info/wxmaxima.md:416
1198msgid "### Opening gnuplot's command console in `plot` windows"
1199msgstr ""
1200
1201#. type: Plain text
1202#: /home/gunter/src/wxmaxima/info/wxmaxima.md:418
1203msgid ""
1204"On MS Windows, if in _Maxima_'s variable `gnuplot_command` \"gnuplot\" is "
1205"replaced by \"wgnuplot\", gnuplot offers the possibility to open a console "
1206"window, where gnuplot commands can be entered into. Unfortunately enabling "
1207"this feature causes gnuplot to \"steal\" the keyboard focus for a short time "
1208"every time a plot is prepared."
1209msgstr ""
1210
1211#. type: Plain text
1212#: /home/gunter/src/wxmaxima/info/wxmaxima.md:420
1213msgid "### Embedding animations into the spreadsheet"
1214msgstr ""
1215
1216#. type: Plain text
1217#: /home/gunter/src/wxmaxima/info/wxmaxima.md:422
1218msgid ""
1219"3D diagrams tend to make it hard to read quantitative data. A viable "
1220"alternative might be to assign the 3rd parameter to the mouse wheel. The "
1221"`with_slider_draw` command is a version of `wxdraw2d` that does prepare "
1222"multiple plots and allows to switch between them by moving the slider on top "
1223"of the screen. _wxMaxima_ allows to export this animation as an animated gif."
1224msgstr ""
1225
1226#. type: Plain text
1227#: /home/gunter/src/wxmaxima/info/wxmaxima.md:424
1228msgid ""
1229"The first two arguments for `with_slider_draw` are the name of the variable "
1230"that is stepped between the plots and a list of the values of these "
1231"variable. The arguments that follow are the ordinary arguments for "
1232"`wxdraw2d`:"
1233msgstr ""
1234
1235#. type: Plain text
1236#: /home/gunter/src/wxmaxima/info/wxmaxima.md:433
1237#, no-wrap
1238msgid ""
1239"    with_slider_draw(\n"
1240"        f,[1,2,3,4,5,6,7,10],\n"
1241"        title=concat(\"f=\",f,\"Hz\"),\n"
1242"        explicit(\n"
1243"            sin(2*%pi*f*x),\n"
1244"            x,0,1\n"
1245"        ),grid=true\n"
1246"    );\n"
1247msgstr ""
1248
1249#. type: Plain text
1250#: /home/gunter/src/wxmaxima/info/wxmaxima.md:435
1251msgid ""
1252"The same functionality for 3D plots is accessible as `with_slider_draw3d`, "
1253"which allows for rotating 3d plots:"
1254msgstr ""
1255
1256#. type: Plain text
1257#: /home/gunter/src/wxmaxima/info/wxmaxima.md:450
1258#, no-wrap
1259msgid ""
1260"    wxanimate_autoplay:true;\n"
1261"    wxanimate_framerate:20;\n"
1262"    with_slider_draw3d(\n"
1263"        α,makelist(i,i,1,360,3),\n"
1264"        title=sconcat(\"α=\",α),\n"
1265"        surface_hide=true,\n"
1266"        contour=both,\n"
1267"        view=[60,α],\n"
1268"        explicit(\n"
1269"            sin(x)*sin(y),\n"
1270"            x,-π,π,\n"
1271"            y,-π,π\n"
1272"        )\n"
1273"    )$\n"
1274msgstr ""
1275
1276#. type: Plain text
1277#: /home/gunter/src/wxmaxima/info/wxmaxima.md:452
1278msgid ""
1279"If the general shape of the plot is what matters it might suffice to move "
1280"the plot just a little bit in order to make it's 3D nature available to the "
1281"intuition:"
1282msgstr ""
1283
1284#. type: Plain text
1285#: /home/gunter/src/wxmaxima/info/wxmaxima.md:467
1286#, no-wrap
1287msgid ""
1288"    wxanimate_autoplay:true;\n"
1289"    wxanimate_framerate:20;\n"
1290"    with_slider_draw3d(\n"
1291"        t,makelist(i,i,0,2*π,.05*π),\n"
1292"        title=sconcat(\"α=\",α),\n"
1293"        surface_hide=true,\n"
1294"        contour=both,\n"
1295"        view=[60,30+5*sin(t)],\n"
1296"        explicit(\n"
1297"            sin(x)*y^2,\n"
1298"            x,-2*π,2*π,\n"
1299"            y,-2*π,2*π\n"
1300"        )\n"
1301"    )$\n"
1302msgstr ""
1303
1304#. type: Plain text
1305#: /home/gunter/src/wxmaxima/info/wxmaxima.md:469
1306msgid ""
1307"For those more familiar with `plot` than with `draw` there is a second set "
1308"of functions:"
1309msgstr ""
1310
1311#. type: Bullet: '* '
1312#: /home/gunter/src/wxmaxima/info/wxmaxima.md:472
1313msgid "`with_slider` and"
1314msgstr ""
1315
1316#. type: Bullet: '* '
1317#: /home/gunter/src/wxmaxima/info/wxmaxima.md:472
1318msgid "`wxanimate`."
1319msgstr ""
1320
1321#. type: Plain text
1322#: /home/gunter/src/wxmaxima/info/wxmaxima.md:474
1323msgid ""
1324"Normally the animations are played back or exported with the frame rate "
1325"chosen in the configuration of _wxMaxima_. To set the speed an individual "
1326"animation is played back the variable `wxanimate_framerate` can be used:"
1327msgstr ""
1328
1329#. type: Plain text
1330#: /home/gunter/src/wxmaxima/info/wxmaxima.md:477
1331#, no-wrap
1332msgid ""
1333"    wxanimate(a, 10,\n"
1334"        sin(a*x), [x,-5,5]), wxanimate_framerate=6$\n"
1335msgstr ""
1336
1337#. type: Plain text
1338#: /home/gunter/src/wxmaxima/info/wxmaxima.md:479
1339msgid ""
1340"The animation functions use _maxima_'s `makelist` command and therefore "
1341"shares the pitfall that the slider variable's value is substituted into the "
1342"expression only if the variable is directly visible in the expression. "
1343"Therefore the following example will fail:"
1344msgstr ""
1345
1346#. type: Plain text
1347#: /home/gunter/src/wxmaxima/info/wxmaxima.md:487
1348#, no-wrap
1349msgid ""
1350"    f:sin(a*x);\n"
1351"    with_slider_draw(\n"
1352"        a,makelist(i/2,i,1,10),\n"
1353"        title=concat(\"a=\",float(a)),\n"
1354"        grid=true,\n"
1355"        explicit(f,x,0,10)\n"
1356"    )$\n"
1357msgstr ""
1358
1359#. type: Plain text
1360#: /home/gunter/src/wxmaxima/info/wxmaxima.md:489
1361msgid ""
1362"If _Maxima_ is explicitly asked to substitute the slider’s value plotting "
1363"works fine instead:"
1364msgstr ""
1365
1366#. type: Plain text
1367#: /home/gunter/src/wxmaxima/info/wxmaxima.md:500
1368#, no-wrap
1369msgid ""
1370"    f:sin(a*x);\n"
1371"    with_slider_draw(\n"
1372"        b,makelist(i/2,i,1,10),\n"
1373"        title=concat(\"a=\",float(b)),\n"
1374"        grid=true,\n"
1375"        explicit(\n"
1376"            subst(a=b,f),\n"
1377"            x,0,10\n"
1378"        )\n"
1379"    )$\n"
1380msgstr ""
1381
1382#. type: Plain text
1383#: /home/gunter/src/wxmaxima/info/wxmaxima.md:502
1384msgid "### Opening multiple plots in contemporaneous windows"
1385msgstr ""
1386
1387#. type: Plain text
1388#: /home/gunter/src/wxmaxima/info/wxmaxima.md:504
1389msgid ""
1390"While not being a provided by _wxMaxima_ this feature of _Maxima_ (on setups "
1391"that support it) sometimes comes in handily. The following example comes "
1392"from a post from Mario Rodriguez to the _Maxima_ mailing list:"
1393msgstr ""
1394
1395#. type: Plain text
1396#: /home/gunter/src/wxmaxima/info/wxmaxima.md:506
1397#, no-wrap
1398msgid "    load(draw);\n"
1399msgstr ""
1400
1401#. type: Plain text
1402#: /home/gunter/src/wxmaxima/info/wxmaxima.md:509
1403#, no-wrap
1404msgid ""
1405"    /* Parabola in window #1 */\n"
1406"    draw2d(terminal=[wxt,1],explicit(x^2,x,-1,1));\n"
1407msgstr ""
1408
1409#. type: Plain text
1410#: /home/gunter/src/wxmaxima/info/wxmaxima.md:512
1411#, no-wrap
1412msgid ""
1413"    /* Parabola in window #2 */\n"
1414"    draw2d(terminal=[wxt,2],explicit(x^2,x,-1,1));\n"
1415msgstr ""
1416
1417#. type: Plain text
1418#: /home/gunter/src/wxmaxima/info/wxmaxima.md:515
1419#, no-wrap
1420msgid ""
1421"    /* Paraboloid in window #3 */\n"
1422"    draw3d(terminal=[wxt,3],explicit(x^2+y^2,x,-1,1,y,-1,1));\n"
1423msgstr ""
1424
1425#. type: Plain text
1426#: /home/gunter/src/wxmaxima/info/wxmaxima.md:517
1427msgid "### The \"Plot using draw\" sidepane"
1428msgstr ""
1429
1430#. type: Plain text
1431#: /home/gunter/src/wxmaxima/info/wxmaxima.md:519
1432msgid ""
1433"The \"Plot using draw\" sidebar hides a simple code generator that allows to "
1434"generate scenes that make use of some of the flexibility of the _draw_ "
1435"package _maxima_ comes with."
1436msgstr ""
1437
1438#. type: Plain text
1439#: /home/gunter/src/wxmaxima/info/wxmaxima.md:521
1440msgid "#### 2D"
1441msgstr ""
1442
1443#. type: Plain text
1444#: /home/gunter/src/wxmaxima/info/wxmaxima.md:523
1445msgid ""
1446"Generates the skeleton of a `draw()` command that draws a 2D scene. This "
1447"scene later has to be filled with commands that generate the scene's "
1448"contents, for example by using the buttons in the rows below the \"2D\" "
1449"button."
1450msgstr ""
1451
1452#. type: Plain text
1453#: /home/gunter/src/wxmaxima/info/wxmaxima.md:525
1454msgid ""
1455"One helpful feature of the 2D button is that it allows to setup the scene as "
1456"an animation in which a variable (by default it is _t_ has a different value "
1457"in each frame: Often an moving 2D plot allows easier interpretation than the "
1458"same data in a non-moving 3D one."
1459msgstr ""
1460
1461#. type: Plain text
1462#: /home/gunter/src/wxmaxima/info/wxmaxima.md:527
1463msgid "#### 3D"
1464msgstr ""
1465
1466#. type: Plain text
1467#: /home/gunter/src/wxmaxima/info/wxmaxima.md:529
1468msgid ""
1469"Generates the skeleton of a `draw()` command that draws a 3D scene. If "
1470"neither a 2D or a 3D scene are set up all of the other buttons set up a 2D "
1471"scene that contains the command the button generates."
1472msgstr ""
1473
1474#. type: Plain text
1475#: /home/gunter/src/wxmaxima/info/wxmaxima.md:531
1476msgid "#### Expression"
1477msgstr ""
1478
1479#. type: Plain text
1480#: /home/gunter/src/wxmaxima/info/wxmaxima.md:533
1481msgid ""
1482"Appends a standard plot of an expression like `sin(x)`, `x*sin(x)` or "
1483"`x^2+2*x-4` to the `draw()` command the cursor currently is in. If there is "
1484"no draw command a 2D scene with the plot is generated. Each scene can be "
1485"filled with any number of plots."
1486msgstr ""
1487
1488#. type: Plain text
1489#: /home/gunter/src/wxmaxima/info/wxmaxima.md:535
1490msgid "#### Implicit plot"
1491msgstr ""
1492
1493#. type: Plain text
1494#: /home/gunter/src/wxmaxima/info/wxmaxima.md:537
1495msgid ""
1496"Tries to find all points an expression like `y=sin(x)`, `y*sin(x)=3` or "
1497"`x^2+y^2=4` is true at and plots the resulting curve in the `draw()` command "
1498"the cursor currently is in. If there is no draw command a 2D scene with the "
1499"plot is generated."
1500msgstr ""
1501
1502#. type: Plain text
1503#: /home/gunter/src/wxmaxima/info/wxmaxima.md:539
1504msgid "#### Parametric plot"
1505msgstr ""
1506
1507#. type: Plain text
1508#: /home/gunter/src/wxmaxima/info/wxmaxima.md:541
1509msgid ""
1510"Steps a variable from a lower limit to an upper limit and uses two "
1511"expressions like `t*sin(t)` and `t*cos(t)` for generating the x, y (and in "
1512"3D plots also z) coordinates of a curve that is put into the current draw "
1513"command."
1514msgstr ""
1515
1516#. type: Plain text
1517#: /home/gunter/src/wxmaxima/info/wxmaxima.md:543
1518msgid "#### Points"
1519msgstr ""
1520
1521#. type: Plain text
1522#: /home/gunter/src/wxmaxima/info/wxmaxima.md:545
1523msgid ""
1524"Draws many points that can optionally be joined. The coordinates of the "
1525"points are taken from a list of lists, a 2D array or one list or array for "
1526"each axis."
1527msgstr ""
1528
1529#. type: Plain text
1530#: /home/gunter/src/wxmaxima/info/wxmaxima.md:547
1531msgid "#### Diagram title"
1532msgstr ""
1533
1534#. type: Plain text
1535#: /home/gunter/src/wxmaxima/info/wxmaxima.md:549
1536msgid "Draws a title on the upper end of the diagram,"
1537msgstr ""
1538
1539#. type: Plain text
1540#: /home/gunter/src/wxmaxima/info/wxmaxima.md:551
1541msgid "#### Axis"
1542msgstr ""
1543
1544#. type: Plain text
1545#: /home/gunter/src/wxmaxima/info/wxmaxima.md:553
1546msgid "Sets up the axis."
1547msgstr ""
1548
1549#. type: Plain text
1550#: /home/gunter/src/wxmaxima/info/wxmaxima.md:555
1551msgid "#### Contour"
1552msgstr ""
1553
1554#. type: Plain text
1555#: /home/gunter/src/wxmaxima/info/wxmaxima.md:557
1556msgid ""
1557"(Only for 3D plots): Adds contour lines similar to the ones one can find in "
1558"a map of a mountain to the plot commands that follow in the current draw() "
1559"command and/or to the ground plane of the diagram. Alternatively this wizard "
1560"allows skipping drawing the curves entirely only showing the contour plot."
1561msgstr ""
1562
1563#. type: Plain text
1564#: /home/gunter/src/wxmaxima/info/wxmaxima.md:559
1565msgid "#### Plot name"
1566msgstr ""
1567
1568#. type: Plain text
1569#: /home/gunter/src/wxmaxima/info/wxmaxima.md:561
1570msgid ""
1571"Adds a legend entry showing the next plot's name to the legend of the "
1572"diagram. An empty name disables generating legend entries for the following "
1573"plots."
1574msgstr ""
1575
1576#. type: Plain text
1577#: /home/gunter/src/wxmaxima/info/wxmaxima.md:563
1578msgid "#### Line color"
1579msgstr ""
1580
1581#. type: Plain text
1582#: /home/gunter/src/wxmaxima/info/wxmaxima.md:565
1583msgid ""
1584"Sets the line color for the following plots the current draw command "
1585"contains."
1586msgstr ""
1587
1588#. type: Plain text
1589#: /home/gunter/src/wxmaxima/info/wxmaxima.md:567
1590msgid "#### Fill color"
1591msgstr ""
1592
1593#. type: Plain text
1594#: /home/gunter/src/wxmaxima/info/wxmaxima.md:569
1595msgid ""
1596"Sets the fill color for the following plots the current draw command "
1597"contains."
1598msgstr ""
1599
1600#. type: Plain text
1601#: /home/gunter/src/wxmaxima/info/wxmaxima.md:571
1602msgid "#### Grid"
1603msgstr ""
1604
1605#. type: Plain text
1606#: /home/gunter/src/wxmaxima/info/wxmaxima.md:573
1607msgid "Pops up a wizard that allows to set up grid lines."
1608msgstr ""
1609
1610#. type: Plain text
1611#: /home/gunter/src/wxmaxima/info/wxmaxima.md:575
1612msgid "#### Accuracy"
1613msgstr ""
1614
1615#. type: Plain text
1616#: /home/gunter/src/wxmaxima/info/wxmaxima.md:577
1617msgid ""
1618"Allows to select an adequate point in the speed vs. accuracy tradeoff that "
1619"is part of any plot program."
1620msgstr ""
1621
1622#. type: Plain text
1623#: /home/gunter/src/wxmaxima/info/wxmaxima.md:579
1624msgid "## Embedding graphics"
1625msgstr ""
1626
1627#. type: Plain text
1628#: /home/gunter/src/wxmaxima/info/wxmaxima.md:581
1629msgid ""
1630"if the `.wxmx` file format is being used embedding files in a _wxMaxima_ "
1631"project can be done as easily as per drag-and-drop. But sometimes (for "
1632"example if an image’s contents might change later on in a session) it is "
1633"better to tell the file to load the image on evaluation:"
1634msgstr ""
1635
1636#. type: Plain text
1637#: /home/gunter/src/wxmaxima/info/wxmaxima.md:583
1638#, no-wrap
1639msgid "    show_image(\"man.png\");\n"
1640msgstr ""
1641
1642#. type: Plain text
1643#: /home/gunter/src/wxmaxima/info/wxmaxima.md:585
1644msgid "## Startup files"
1645msgstr ""
1646
1647#. type: Plain text
1648#: /home/gunter/src/wxmaxima/info/wxmaxima.md:587
1649msgid ""
1650"The config dialogue of _wxMaxima_ offers to edit two files with commands "
1651"that are executed on startup:"
1652msgstr ""
1653
1654#. type: Bullet: '* '
1655#: /home/gunter/src/wxmaxima/info/wxmaxima.md:590
1656msgid ""
1657"A file that contains commands that are executed on starting up _Maxima_: `~/."
1658"maxima/maxima-init.mac`"
1659msgstr ""
1660
1661#. type: Bullet: '* '
1662#: /home/gunter/src/wxmaxima/info/wxmaxima.md:590
1663msgid ""
1664"one file of additional commands that are executed if _wxMaxima_ is starting "
1665"_Maxima_: `~/.maxima/wxmaxima-init.mac`"
1666msgstr ""
1667
1668#. type: Plain text
1669#: /home/gunter/src/wxmaxima/info/wxmaxima.md:592
1670msgid ""
1671"These files are in the Maxima user directory, usually `.maxima/` in the "
1672"user's home directory, the location can be found out with the command: "
1673"`maxima_userdir;`"
1674msgstr ""
1675
1676#. type: Plain text
1677#: /home/gunter/src/wxmaxima/info/wxmaxima.md:594
1678msgid "## Special variables wx..."
1679msgstr ""
1680
1681#. type: Bullet: '* '
1682#: /home/gunter/src/wxmaxima/info/wxmaxima.md:602
1683msgid ""
1684"`wxsubscripts` tells _Maxima_ if it should convert variable names that "
1685"contain an underscore (`R_150` or the like) into subscripted variables. See "
1686"`wxdeclare_subscript` for details which variable names are automatically "
1687"converted."
1688msgstr ""
1689
1690#. type: Bullet: '* '
1691#: /home/gunter/src/wxmaxima/info/wxmaxima.md:602
1692msgid ""
1693"`wxfilename`: This variable contains the name of the file currently opened "
1694"in _wxMaxima_."
1695msgstr ""
1696
1697#. type: Bullet: '* '
1698#: /home/gunter/src/wxmaxima/info/wxmaxima.md:602
1699msgid ""
1700"`wxplot_pngcairo` tells whether _wxMaxima_ tries to use _gnuplot_’s pngcairo "
1701"terminal that provides more line styles and a better overall graphics "
1702"quality."
1703msgstr ""
1704
1705#. type: Bullet: '* '
1706#: /home/gunter/src/wxmaxima/info/wxmaxima.md:602
1707msgid "`wxplot_size` defines the resolution of embedded plots."
1708msgstr ""
1709
1710#. type: Bullet: '* '
1711#: /home/gunter/src/wxmaxima/info/wxmaxima.md:602
1712msgid ""
1713"`wxchangedir`: On most operating systems _wxMaxima_ automatically sets "
1714"_Maxima_’s working directory to the directory of the current file. This "
1715"allows file I/O (e.g. by `read_matrix`) to work without specifying the whole "
1716"path to the file that has to be read or written. On Windows this feature "
1717"sometimes causes error messages and therefore can be set to `false` from the "
1718"config dialogue."
1719msgstr ""
1720
1721#. type: Bullet: '* '
1722#: /home/gunter/src/wxmaxima/info/wxmaxima.md:602
1723msgid ""
1724"`wxanimate_framerate`: The number of frames per second the following "
1725"animations have to be played back with."
1726msgstr ""
1727
1728#. type: Bullet: '* '
1729#: /home/gunter/src/wxmaxima/info/wxmaxima.md:602
1730msgid "`wxanimate_autoplay`: Automatically play animations by default?"
1731msgstr ""
1732
1733#. type: Plain text
1734#: /home/gunter/src/wxmaxima/info/wxmaxima.md:604
1735msgid "## Pretty-printing 2D output"
1736msgstr ""
1737
1738#. type: Plain text
1739#: /home/gunter/src/wxmaxima/info/wxmaxima.md:606
1740msgid ""
1741"The function `table_form()` displays a 2D list in a form that is more "
1742"readable than the output _Maxima_’s default output routine. The input is a "
1743"list of one or more lists. Like the print command, this command displays "
1744"output even when ended with a dollar sign. Ending the command with a "
1745"semicolon results in the same table along with a \"done\" statement."
1746msgstr ""
1747
1748#. type: Plain text
1749#: /home/gunter/src/wxmaxima/info/wxmaxima.md:613
1750#, no-wrap
1751msgid ""
1752"    table_form(\n"
1753"        [\n"
1754"            [1,2],\n"
1755"            [3,4]\n"
1756"        ]\n"
1757"    )$\n"
1758msgstr ""
1759
1760#. type: Plain text
1761#: /home/gunter/src/wxmaxima/info/wxmaxima.md:615
1762msgid ""
1763"As the next example shows, the lists that are assembled by the `table_form` "
1764"command can be created before the command is executed."
1765msgstr ""
1766
1767#. type: Plain text
1768#: /home/gunter/src/wxmaxima/info/wxmaxima.md:617
1769msgid ""
1770"![A third table example](./MatrixTableExample.png)"
1771"{ id=img_MatrixTableExample }"
1772msgstr ""
1773
1774#. type: Plain text
1775#: /home/gunter/src/wxmaxima/info/wxmaxima.md:619
1776msgid ""
1777"Also, because a matrix is a list of lists, matrices can be converted to "
1778"tables in a similar fashion."
1779msgstr ""
1780
1781#. type: Plain text
1782#: /home/gunter/src/wxmaxima/info/wxmaxima.md:621
1783msgid ""
1784"![Another table_form example](./SecondTableExample.png)"
1785"{ id=img_SecondTableExample }"
1786msgstr ""
1787
1788#. type: Plain text
1789#: /home/gunter/src/wxmaxima/info/wxmaxima.md:623
1790msgid "## Bug reporting"
1791msgstr ""
1792
1793#. type: Plain text
1794#: /home/gunter/src/wxmaxima/info/wxmaxima.md:625
1795msgid ""
1796"_wxMaxima_ provides a few functions that gather bug reporting information "
1797"about the current system:"
1798msgstr ""
1799
1800#. type: Bullet: '* '
1801#: /home/gunter/src/wxmaxima/info/wxmaxima.md:628
1802msgid ""
1803"`wxbuild_info()` gathers information about the currently running version of "
1804"_wxMaxima_"
1805msgstr ""
1806
1807#. type: Bullet: '* '
1808#: /home/gunter/src/wxmaxima/info/wxmaxima.md:628
1809msgid "`wxbug_report()` tells how and where to file bugs"
1810msgstr ""
1811
1812#. type: Plain text
1813#: /home/gunter/src/wxmaxima/info/wxmaxima.md:631
1814msgid "## Marking output being drawn in red"
1815msgstr ""
1816
1817#. type: Plain text
1818#: /home/gunter/src/wxmaxima/info/wxmaxima.md:633
1819msgid ""
1820"_Maxima_'s `box()` command causes _wxMaxima_ to print its argument with a "
1821"red foreground."
1822msgstr ""
1823
1824#. type: Plain text
1825#: /home/gunter/src/wxmaxima/info/wxmaxima.md:638
1826#, no-wrap
1827msgid ""
1828"Troubleshooting\n"
1829"===============\n"
1830msgstr ""
1831
1832#. type: Plain text
1833#: /home/gunter/src/wxmaxima/info/wxmaxima.md:641
1834msgid "## Cannot connect to _Maxima_"
1835msgstr ""
1836
1837#. type: Plain text
1838#: /home/gunter/src/wxmaxima/info/wxmaxima.md:643
1839msgid ""
1840"Since _Maxima_ (the program that does the actual mathematics) and _wxMaxima_ "
1841"(providing the easy-to-use user interface) are separate programs that "
1842"communicate by the means of a local network connection. Therefore the most "
1843"probable cause is that this connection is somehow not working. For example a "
1844"firewall could be set up in a way that it doesn’t just prevent against "
1845"unauthorized connections from the internet (and perhaps to intercept some "
1846"connections to the internet, too), but it also to blocks inter-process-"
1847"communication inside the same computer. Note that since _Maxima_ is being "
1848"run by a Lisp processor the process communication that is blocked from does "
1849"not necessarily have to be named \"maxima\". Common names of the program "
1850"that opens the network connection would be sbcl, gcl, ccl, lisp.exe or "
1851"similar names."
1852msgstr ""
1853
1854#. type: Plain text
1855#: /home/gunter/src/wxmaxima/info/wxmaxima.md:645
1856msgid ""
1857"On Un\\*x computers another possible reason would be that the loopback "
1858"network that provides network connections between two programs in the same "
1859"computer isn’t properly configured."
1860msgstr ""
1861
1862#. type: Plain text
1863#: /home/gunter/src/wxmaxima/info/wxmaxima.md:647
1864msgid "## How to save data from a broken .wxmx file"
1865msgstr ""
1866
1867#. type: Plain text
1868#: /home/gunter/src/wxmaxima/info/wxmaxima.md:649
1869msgid ""
1870"Internally most modern xml-based formats are ordinary zip-files. wxMaxima "
1871"doesn't turn on compression which makes the contents of .wxmx files viewable "
1872"in any text editor."
1873msgstr ""
1874
1875#. type: Plain text
1876#: /home/gunter/src/wxmaxima/info/wxmaxima.md:651
1877msgid ""
1878"If the zip signature at the end of the file is still intact after renaming a "
1879"broken .wxmx file to .zip most operating systems will provide a way to "
1880"extract any portion of information that is stored inside it. The can be done "
1881"when there is the need of recovering the original image files from a text "
1882"processor document. If the zip signature isn’t intact that does not need to "
1883"be the end of the world: If _wxMaxima_ during saving detected that something "
1884"went wrong there will be a wxmx~ file whose contents might help and even if "
1885"there isn’t such a file: If the configuration option is set that .wxmx files "
1886"have to be optimized for version control it is possible to rename the .wxmx "
1887"file to a .txt file and to use a text editor to recover the XML portion of "
1888"the file's contents."
1889msgstr ""
1890
1891#. type: Plain text
1892#: /home/gunter/src/wxmaxima/info/wxmaxima.md:653
1893msgid ""
1894"If the text file containing this contents is saved as a file ending in .xml "
1895"_wxMaxima_ will know how to recover the text of the document from it."
1896msgstr ""
1897
1898#. type: Plain text
1899#: /home/gunter/src/wxmaxima/info/wxmaxima.md:655
1900msgid ""
1901"## I want some debug info to be displayed on the screen before my command "
1902"has finished"
1903msgstr ""
1904
1905#. type: Plain text
1906#: /home/gunter/src/wxmaxima/info/wxmaxima.md:657
1907msgid ""
1908"Normally _wxMaxima_ waits for the whole 2D formula to be transferred before "
1909"it begins to typeset. This saves time for making many attempts to typeset a "
1910"only partially completed equation. There is a `disp` command, though, that "
1911"will provide debug output immediately and without waiting for the current "
1912"_Maxima_ command to finish:"
1913msgstr ""
1914
1915#. type: Plain text
1916#: /home/gunter/src/wxmaxima/info/wxmaxima.md:665
1917#, no-wrap
1918msgid ""
1919"    for i:1 thru 10 do (\n"
1920"       disp(i),\n"
1921"       /* (sleep n) is a Lisp function, which can be used */\n"
1922"       /* with the character \"?\" before. It delays the */\n"
1923"       /* program execution (here: for 3 seconds) */\n"
1924"       ?sleep(3)\n"
1925"    )$\n"
1926msgstr ""
1927
1928#. type: Plain text
1929#: /home/gunter/src/wxmaxima/info/wxmaxima.md:667
1930msgid "## Plotting only shows a closed empty envelope with an error message"
1931msgstr ""
1932
1933#. type: Plain text
1934#: /home/gunter/src/wxmaxima/info/wxmaxima.md:669
1935msgid ""
1936"This means that _wxMaxima_ could not read the file _Maxima_ that was "
1937"supposed to instruct gnuplot to create."
1938msgstr ""
1939
1940#. type: Plain text
1941#: /home/gunter/src/wxmaxima/info/wxmaxima.md:671
1942msgid "Possible reasons for this error are:"
1943msgstr ""
1944
1945#. type: Bullet: '* '
1946#: /home/gunter/src/wxmaxima/info/wxmaxima.md:676
1947msgid ""
1948"The plotting command is part of a third-party package like `implicit_plot` "
1949"but this package was not loaded by _Maxima_’s `load()` command before trying "
1950"to plot."
1951msgstr ""
1952
1953#. type: Bullet: '* '
1954#: /home/gunter/src/wxmaxima/info/wxmaxima.md:676
1955msgid ""
1956"_Maxima_ tried to do something the currently installed version of gnuplot "
1957"isn’t able to understand. In this case a file ending in .gnuplot in the "
1958"directory _Maxima_’s variable maxima\\_userdir points to contains the "
1959"instructions from _Maxima_ to gnuplot. Most of the time this file’s contents "
1960"therefore are helpful when debugging the problem."
1961msgstr ""
1962
1963#. type: Bullet: '* '
1964#: /home/gunter/src/wxmaxima/info/wxmaxima.md:676
1965msgid ""
1966"Gnuplot was instructed to use the pngcairo library that provides "
1967"antialiasing and additional line styles, but it was not compiled to support "
1968"this possibility. Solution: Uncheck the \"Use the cairo terminal for plot\" "
1969"checkbox in the configuration dialog and don’t set `wxplot_pngcairo` to true "
1970"from _Maxima_."
1971msgstr ""
1972
1973#. type: Bullet: '* '
1974#: /home/gunter/src/wxmaxima/info/wxmaxima.md:676
1975msgid "Gnuplot didn’t output a valid .png file."
1976msgstr ""
1977
1978#. type: Plain text
1979#: /home/gunter/src/wxmaxima/info/wxmaxima.md:678
1980msgid "## Plotting an animation results in “error: undefined variable”"
1981msgstr ""
1982
1983#. type: Plain text
1984#: /home/gunter/src/wxmaxima/info/wxmaxima.md:680
1985msgid ""
1986"The value of the slider variable by default is only substituted into the "
1987"expression that is to be plotted if it is visible there. Using a `subst` "
1988"command that substitutes the slider variable into the equation to plot "
1989"(there should be an example of this in this manual) resolves this problem."
1990msgstr ""
1991
1992#. type: Plain text
1993#: /home/gunter/src/wxmaxima/info/wxmaxima.md:682
1994msgid "## I lost a cell contents and undo doesn’t remember"
1995msgstr ""
1996
1997#. type: Plain text
1998#: /home/gunter/src/wxmaxima/info/wxmaxima.md:684
1999msgid ""
2000"There are separate undo functions for cell operations and for changes inside "
2001"of cells so chances are low that this ever happens. If it does there are "
2002"several methods to recover data:"
2003msgstr ""
2004
2005#. type: Bullet: '* '
2006#: /home/gunter/src/wxmaxima/info/wxmaxima.md:689
2007msgid ""
2008"_wxMaxima_ actually has two undo features: The global undo buffer that is "
2009"active if no cell is selected and a per-cell undo buffer that is active if "
2010"the cursor is inside a cell. It is worth trying to use both undo options in "
2011"order to see if an old value can still be accessed."
2012msgstr ""
2013
2014#. type: Bullet: '* '
2015#: /home/gunter/src/wxmaxima/info/wxmaxima.md:689
2016msgid ""
2017"If you still have a way to find out what label _Maxima_ has assigned to the "
2018"cell just type in the cell’s label and its contents will reappear."
2019msgstr ""
2020
2021#. type: Bullet: '* '
2022#: /home/gunter/src/wxmaxima/info/wxmaxima.md:689
2023msgid ""
2024"If you don’t: Don’t panic. In the “View” menu there is a way to show a "
2025"history pane that shows all _Maxima_ commands that have been issued recently."
2026msgstr ""
2027
2028#. type: Bullet: '* '
2029#: /home/gunter/src/wxmaxima/info/wxmaxima.md:689
2030msgid "If nothing else helps _Maxima_ contains a replay feature:"
2031msgstr ""
2032
2033#. type: Plain text
2034#: /home/gunter/src/wxmaxima/info/wxmaxima.md:693
2035msgid "~~~~ playback(); ~~~~"
2036msgstr ""
2037
2038#. type: Plain text
2039#: /home/gunter/src/wxmaxima/info/wxmaxima.md:695
2040msgid "## _wxMaxima_ starts up with the message “Maxima process terminated.”"
2041msgstr ""
2042
2043#. type: Plain text
2044#: /home/gunter/src/wxmaxima/info/wxmaxima.md:697
2045msgid ""
2046"One possible reason is that _Maxima_ cannot be found in the location that is "
2047"set in the “Maxima” tab of _wxMaxima_’s configuration dialog and therefore "
2048"won’t run at all. Setting the path to a working _Maxima_ binary should fix "
2049"this problem."
2050msgstr ""
2051
2052#. type: Plain text
2053#: /home/gunter/src/wxmaxima/info/wxmaxima.md:699
2054msgid "## Maxima is forever calculating and not responding to input"
2055msgstr ""
2056
2057#. type: Plain text
2058#: /home/gunter/src/wxmaxima/info/wxmaxima.md:701
2059msgid ""
2060"It is theoretically possible that _wxMaxima_ doesn’t realize that _Maxima_ "
2061"has finished calculating and therefore never gets informed it can send new "
2062"data to _Maxima_. If this is the case “Trigger evaluation” might "
2063"resynchronize the two programs."
2064msgstr ""
2065
2066#. type: Plain text
2067#: /home/gunter/src/wxmaxima/info/wxmaxima.md:703
2068msgid "## My SBCL-based _Maxima_ runs out of memory"
2069msgstr ""
2070
2071#. type: Plain text
2072#: /home/gunter/src/wxmaxima/info/wxmaxima.md:705
2073msgid ""
2074"The Lisp compiler SBCL by default comes with a memory limit that allows it "
2075"to run even on low-end computers. When compiling a big software package like "
2076"lapack or dealing with extremely big lists or equations this limit might be "
2077"too low. In order to extend the limits sbcl can be provided with the command "
2078"line parameter `--dynamic-space-size` that tells SBCL how many megabytes it "
2079"should reserve. A 32bit Windows-SBCL can reserve up to 999 Megabytes. A 64-"
2080"bit SBCL version running on Windows can be instructed to use more than the "
2081"about 1280 Megabytes compiling lapack needs."
2082msgstr ""
2083
2084#. type: Plain text
2085#: /home/gunter/src/wxmaxima/info/wxmaxima.md:707
2086msgid ""
2087"One way to provide _Maxima_ (and thus SBCL) with command line parameters is "
2088"the \"Additional parameters for Maxima\" field of _wxMaxima_’s configuration "
2089"dialogue."
2090msgstr ""
2091
2092#. type: Plain text
2093#: /home/gunter/src/wxmaxima/info/wxmaxima.md:709
2094msgid "![sbcl memory](./sbclMemory.png){ id=img_sbclMemory }"
2095msgstr ""
2096
2097#. type: Plain text
2098#: /home/gunter/src/wxmaxima/info/wxmaxima.md:712
2099msgid "## Input sometimes is sluggish/ignoring keys on Ubuntu"
2100msgstr ""
2101
2102#. type: Plain text
2103#: /home/gunter/src/wxmaxima/info/wxmaxima.md:714
2104msgid ""
2105"Installing the package `ibus-gtk` should resolve this issue. See ([https://"
2106"bugs.launchpad.net/ubuntu/+source/wxwidgets3.0/+bug/1421558](https://bugs."
2107"launchpad.net/ubuntu/+source/wxwidgets3.0/+bug/1421558)) for details."
2108msgstr ""
2109
2110#. type: Plain text
2111#: /home/gunter/src/wxmaxima/info/wxmaxima.md:716
2112msgid "## _wxMaxima_ halts when _Maxima_ processes Greek characters or Umlauts"
2113msgstr ""
2114
2115#. type: Plain text
2116#: /home/gunter/src/wxmaxima/info/wxmaxima.md:718
2117msgid ""
2118"If your _Maxima_ is based on SBCL the following lines have to be added to "
2119"your `.sbclrc`:"
2120msgstr ""
2121
2122#. type: Plain text
2123#: /home/gunter/src/wxmaxima/info/wxmaxima.md:720
2124#, no-wrap
2125msgid "    (setf sb-impl::*default-external-format* :utf-8)\n"
2126msgstr ""
2127
2128#. type: Plain text
2129#: /home/gunter/src/wxmaxima/info/wxmaxima.md:722
2130msgid ""
2131"The folder this file has to be placed in is system- and installation-"
2132"specific. But any sbcl-based _Maxima_ that already has evaluated a cell in "
2133"the current session will happily tell where it can be found after getting "
2134"the following command:"
2135msgstr ""
2136
2137#. type: Plain text
2138#: /home/gunter/src/wxmaxima/info/wxmaxima.md:724
2139#, no-wrap
2140msgid "    :lisp (sb-impl::userinit-pathname)\n"
2141msgstr ""
2142
2143#. type: Plain text
2144#: /home/gunter/src/wxmaxima/info/wxmaxima.md:728
2145msgid ""
2146"### Can I make _wxMaxima_ output both image files and embedded plots at once?"
2147msgstr ""
2148
2149#. type: Plain text
2150#: /home/gunter/src/wxmaxima/info/wxmaxima.md:730
2151msgid ""
2152"The worksheet embeds .png files. wxMaxima allows the user to specify where "
2153"they should be generated:"
2154msgstr ""
2155
2156#. type: Plain text
2157#: /home/gunter/src/wxmaxima/info/wxmaxima.md:737
2158#, no-wrap
2159msgid ""
2160"~~~~\n"
2161"wxdraw2d(\n"
2162"    file_name=\"test\",\n"
2163"    explicit(sin(x),x,1,10)\n"
2164");\n"
2165"~~~~\n"
2166msgstr ""
2167
2168#. type: Plain text
2169#: /home/gunter/src/wxmaxima/info/wxmaxima.md:739
2170msgid ""
2171"If a different format is to be used it is easier to generate the images and "
2172"then to import them into the worksheet again:"
2173msgstr ""
2174
2175#. type: Plain text
2176#: /home/gunter/src/wxmaxima/info/wxmaxima.md:758
2177#, no-wrap
2178msgid ""
2179"~~~~\n"
2180"load(\"draw\");\n"
2181"pngdraw(name,[contents]):=\n"
2182"(\n"
2183"    draw(\n"
2184"        append(\n"
2185"            [\n"
2186"                terminal=pngcairo,\n"
2187"                dimensions=wxplot_size,\n"
2188"                file_name=name\n"
2189"            ],\n"
2190"            contents\n"
2191"        )\n"
2192"    ),\n"
2193"    show_image(printf(false,\"~a.png\",name))\n"
2194");\n"
2195"pngdraw2d(name,[contents]):=\n"
2196"    pngdraw(name,gr2d(contents));\n"
2197msgstr ""
2198
2199#. type: Plain text
2200#: /home/gunter/src/wxmaxima/info/wxmaxima.md:763
2201#, no-wrap
2202msgid ""
2203"pngdraw2d(\"Test\",\n"
2204"        explicit(sin(x),x,1,10)\n"
2205");\n"
2206"~~~~\n"
2207msgstr ""
2208
2209#. type: Plain text
2210#: /home/gunter/src/wxmaxima/info/wxmaxima.md:765
2211msgid "### Can I set the aspect ratio of a plot?"
2212msgstr ""
2213
2214#. type: Plain text
2215#: /home/gunter/src/wxmaxima/info/wxmaxima.md:767
2216msgid "Not directly using _Maxima_. But there are gnuplot commands for it:"
2217msgstr ""
2218
2219#. type: Plain text
2220#: /home/gunter/src/wxmaxima/info/wxmaxima.md:772
2221#, no-wrap
2222msgid ""
2223"     wxdraw2d(\n"
2224"         proportional_axis=xy,\n"
2225"         explicit(sin(x),x,1,10)\n"
2226"     ),wxplot_size=[1000,1000];\n"
2227msgstr ""
2228
2229#. type: Plain text
2230#: /home/gunter/src/wxmaxima/info/wxmaxima.md:777
2231#, no-wrap
2232msgid ""
2233"FAQ\n"
2234"===\n"
2235msgstr ""
2236
2237#. type: Plain text
2238#: /home/gunter/src/wxmaxima/info/wxmaxima.md:780
2239msgid "## Is there a way to make more text fit on a pdfLaTeX page?"
2240msgstr ""
2241
2242#. type: Plain text
2243#: /home/gunter/src/wxmaxima/info/wxmaxima.md:782
2244msgid ""
2245"There is: Just add the following lines to the LaTeX preamble (for example by "
2246"using the respective field in the config dialogue (\"Export\"->\"Additional "
2247"lines for the TeX preamble\"):"
2248msgstr ""
2249
2250#. type: Plain text
2251#: /home/gunter/src/wxmaxima/info/wxmaxima.md:784
2252#, no-wrap
2253msgid "    \\usepackage[left=1cm,right=1cm,top=1cm,bottom=1cm]{geometry}\n"
2254msgstr ""
2255
2256#. type: Plain text
2257#: /home/gunter/src/wxmaxima/info/wxmaxima.md:786
2258msgid "## Is there a dark mode?"
2259msgstr ""
2260
2261#. type: Plain text
2262#: /home/gunter/src/wxmaxima/info/wxmaxima.md:788
2263msgid ""
2264"If wxWidgets is new enough wxMaxima will automatically be in dark mode if "
2265"the rest of the operating system is. The worksheet itself is by default "
2266"equipped with a bright background. But it can be configured otherwise. "
2267"Alternatively there is a `View/Invert worksheet brightness` menu entry that "
2268"allows to quickly convert the worksheet from dark to bright and vice versa."
2269msgstr ""
2270
2271#. type: Plain text
2272#: /home/gunter/src/wxmaxima/info/wxmaxima.md:790
2273msgid ""
2274"## wxMaxima sometimes hangs for a several seconds once in the first minute"
2275msgstr ""
2276
2277#. type: Plain text
2278#: /home/gunter/src/wxmaxima/info/wxmaxima.md:792
2279msgid ""
2280"wxMaxima delegates some big tasks like parsing maxima's >1000-page-manual to "
2281"background tasks, which normally goes totally unnoticed. In the moment the "
2282"result of such a task is needed, though, it is possible that wxMaxima needs "
2283"to wait a couple of seconds before it can continue its work."
2284msgstr ""
2285
2286#. type: Plain text
2287#: /home/gunter/src/wxmaxima/info/wxmaxima.md:797
2288#, no-wrap
2289msgid ""
2290"Command-line arguments\n"
2291"======================\n"
2292msgstr ""
2293
2294#. type: Plain text
2295#: /home/gunter/src/wxmaxima/info/wxmaxima.md:800
2296msgid ""
2297"Most operating systems provide less complicated ways of starting programs "
2298"than the command line so this possibility is only rarely used. _wxMaxima_ "
2299"still provides some command line switches, though."
2300msgstr ""
2301
2302#. type: Bullet: '* '
2303#: /home/gunter/src/wxmaxima/info/wxmaxima.md:814
2304msgid "`-v` or `--version`: Output the version information"
2305msgstr ""
2306
2307#. type: Bullet: '* '
2308#: /home/gunter/src/wxmaxima/info/wxmaxima.md:814
2309msgid "`-h` or `--help`: Output a short help text"
2310msgstr ""
2311
2312#. type: Bullet: '* '
2313#: /home/gunter/src/wxmaxima/info/wxmaxima.md:814
2314msgid ""
2315"`-o` or `--open=<str>`: Open the filename given as argument to this command-"
2316"line switch"
2317msgstr ""
2318
2319#. type: Bullet: '* '
2320#: /home/gunter/src/wxmaxima/info/wxmaxima.md:814
2321msgid "`-e` or `--eval`: Evaluate the file after opening it."
2322msgstr ""
2323
2324#. type: Bullet: '* '
2325#: /home/gunter/src/wxmaxima/info/wxmaxima.md:814
2326msgid ""
2327"`-b` or `--batch`: If the command-line opens a file all cells in this file "
2328"are evaluated and the file is saved afterwards. This is for example useful "
2329"if the session described in the file makes _Maxima_ generate output files. "
2330"Batch-processing will be stopped if _wxMaxima_ detects that _Maxima_ has "
2331"output an error and will pause if _Maxima_ has a question: Mathematics is "
2332"somewhat interactive by nature so a completely interaction-free batch "
2333"processing cannot always be guaranteed."
2334msgstr ""
2335
2336#. type: Plain text
2337#: /home/gunter/src/wxmaxima/info/wxmaxima.md:814
2338#, no-wrap
2339msgid ""
2340"* `--logtostdout`:                 Log all \"debug messages\" sidebar messages to stderr, too.\n"
2341"* `--pipe`:                        Pipe messages from Maxima to stdout.\n"
2342"* `--exit-on-error`:               Close the program on any maxima error.\n"
2343"* `-f` or `--ini=<str>`: Use the init file that was given as argument to this command-line switch\n"
2344"* `-u`, `--use-version=<str>`:     Use maxima version `<str>`.\n"
2345"* `-l`, `--lisp=<str>`:              Use a Maxima compiled with Lisp compiler `<str>`.\n"
2346"* `-X`, `--extra-args=<str>`:        Allows to specify extra Maxima arguments\n"
2347"* `-m` or `--maxima=<str>`:    allows to specify the location of the _maxima_ binary\n"
2348msgstr ""
2349
2350#. type: Plain text
2351#: /home/gunter/src/wxmaxima/info/wxmaxima.md:815
2352msgid ""
2353"Instead of a minus some operating systems might use a dash in front of the "
2354"command-line switches."
2355msgstr ""
2356