WxMaxima

# 1 The wxMaxima user manual

WxMaxima is a graphical user interface (GUI) for the Maxima computer algebra system (CAS). WxMaxima allows one to use all of _Maxima_â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 Maxima.

Logotipo wxMaxima

# 2 Introduction to wxMaxima

## 2.1 Maxima and wxMaxima

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.

Un sistema de computación algebraico (CAS) como Maxima encaja dentro de este marco referencial. Un CAS puede proporcionar la lógica detrás de la aplicación de precisión de cálculo arbitrario o puede hacer transformaciones automáticas de fórmulas en el segundo plano de un sistema más grande (p.e., [Sage] (https://www.sagemath.org/)). Alternativamente, puede ser utilizado directamente como un sistema independiente. Maxima pude ser accedido vía una línea de instrucción. A menudo, sin embargo, un interfaz como wxMaxima proporciona una manera más eficiente para acceder al software, especialmente para los recién llegados.

### 2.1.1 Maxima

Maxima es un sistema algebraico computador completo (CAS) de características. Un CAS es un programa que puede resolver problemas matemáticos reconociendo fórmulas y encontrando una fórmula que resuelva el problema como difícil a ajustar la salida del valor numérico del resultado. En otras palabras, Maxima pude servir como una calculadora que proporciona representaciones numéricas de variables, y además puede proporcionar soluciones analíticas. Más aún, ofrece un rango de métodos numéricos para ecuaciones o sistemas de ecuaciones que no pueden ser analíticamente resueltos.

Pantallazo de Maxima, línea intrucción

Extensive documentation for Maxima is available in the internet. Part of this documentation is also available in wxMaximaâs help menu. Pressing the Help key (on most systems the `F1` key) causes _wxMaxima_âs context-sensitive help feature to automatically jump to _Maxima_âs manual page for the command at the cursor.

### 2.1.2 WxMaxima

WxMaxima is a graphical user interface that provides the full functionality and flexibility of Maxima. WxMaxima offers users a graphical display and many features that make working with Maxima easier. For example wxMaxima 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 wxMaxima, including workbooks to illustrate aspects of its use, is online at the wxMaxima help site, as well as via the help menu.

Ventana de wxMaxima

Los cálculos que son introducidos en wxMaxima son realizados por la herramienta de línea de instrucciones de Maxima en el segundo plano.

## 2.2 Workbook basics

Much of wxMaxima is self-explaining, but some details require attention. This site contains a number of workbooks that address various aspects of wxMaxima. Working through some of these (particularly the “10 minute (wx)Maxima tutorial”) will increase oneâs familiarity with both the content of Maxima and the use of wxMaxima to interact with Maxima. This manual concentrates on describing aspects of wxMaxima that are not likely to be self-evident and that might not be covered in the online material.

### 2.2.1 The workbook approach

One of the very few things that are not standard in wxMaxima is that it organizes the data for Maxima into cells that are evaluated (which means: sent to Maxima) 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 Maxima to evaluate all cells in a workbook in one pass.) _WxMaxima_â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.

Si el texto está tecleado en wxMaxima automáticamente crea una celda de hoja de trabajo nueva. El tipo de esta celda puede ser seleccionado en la barra de herramientas. Si se crea una celda de código, la celda puede ser enviada a Maxima, la cual causa que el resultado del cálculo es desplegado debajo del código. Una pareja de dichas instrucciones se muestra debajo.

Celda de entrada/salida

On evaluation of an input cellâs contents the input cell Maxima assigns a label to the input (by default shown in red and recognizable by the `%i`) by which it can be referenced later in the wxMaxima session. The output that Maxima generates also gets a label that begins with `%o` 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 `%o`-style label Maxima auto-generates will also be accessible, though.

Al lado de las celdas de entradas wxMaxima permite celdas de texto para documentación, celdas de imagen, celdas de título, celdas de capítulo y celdas de sección. Cada celda tiene su propio tampón para deshacer por lo que se depura a través de modificar los valores de varias celdas y después gradualmente es más fácil revertir las modificaciones no necesarias. Además la misma hoja de trabajo tiene un tampón global para deshacer que puede deshacer celdas editadas, agregar y borrar.

La figura inferior muestra tipos de celda diferentes (celdas título, sección, subsección, texto, E/S e imagen).

Ejemplo de celdas wxMaxima

### 2.2.2 Cells

La hoja de trabajo está organizada dentro de celdas. wxmaxima conoce los tipos de celdas siguientes:

- Math cells, containing one or more lines of Maxima input.
- Output of, or a question from, Maxima.
- Image cells.
- Text cells, that can for example be used for documentation.
- A title, section or a subsection. 6 levels of different headings are possible.
- Page breaks.

El comportamiento predeterminado de wxMaxima cuando el texto es teclado para creación automática de una celda matemática. Las celdas de otros tipos puede ser creadas utilizando el menú Celda, utilizando las teclas resaltadas mostradas dentro del menú o utilizando el listado de arrastrar-bajar dentro de la barra de herramientas. Una vez que la celda no matemática es creada, lo que se teclee dentro del archivo es interpretado como texto.

Un [comentario de texto] (C-style)(https://maxima.sourceforge.io/docs/manual/maxima_singlepage.html#Comments) puede ser parte de una celda matemática como sigue: `/* Este comentario será ignorado por Maxima */`

“`/*`” marca el inicio del comentario, “`*/`” el final.

### 2.2.3 Horizontal and vertical cursors

Si el usuario intenta seccionar una oración completa, un procesador de palabras intentará extender la selección para iniciar y finalizar automáticamente con una palabra acotada. Así mismo, si está seleccionada más de una celda, wxMaxima extenderá la selección a todas las celdas.

What isnât standard is that wxMaxima provides drag-and-drop flexibility by defining two types of cursors. WxMaxima will switch between them automatically when needed:

- El cursor es dibujado horizontalmente si es trasladado dentro del espacio entre dos celdas o pulsando allí.
- 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.

When you start wxMaxima, you will only see the blinking horizontal cursor. If you start typing, a math cell will be automatically created and the cursor will change to a regular vertical one (you will see a right arrow as “prompt”, after the Math cell is evaluated (`CTRL`+`ENTER`), you will see the labels, e.g. `(%i1)`, `(%o1)`).

(parpadeando) cursor horizontal tras iniciar wxMaxima

Quizá desea crear un tipo de celda diferente (utilizando el menú «Celda»), puede ser una celda titular o de texto, la cual describe que será hecho, cuando inicia crear su hoja de trabajo.

Si navegas entre las celdas diferentes, además verá el (parpadeo) cursor horizontal, donde puede insertar una celda a su hoja de trabajo (bien una celda matemática, por tan solo inicie tecleando su fórmula - o un tipo de celda diferente utilizando el menú).

(parpadeo) del cursor horizontal entre celdas

### 2.2.4 Sending cells to Maxima

The command in a code cell is executed once by pressing `CTRL`+`ENTER`, `SHIFT`+`ENTER` or the `ENTER` key on the keypad. The wxMaxima default is to enter commands when either `CTRL`+`ENTER` or `SHIFT`+`ENTER` is entered, but wxMaxima can be configured to execute commands in response to `ENTER`.

### 2.2.5 Command autocompletion

WxMaxima contains an autocompletion feature that is triggered via the menu (Cell/Complete Word) or alternatively by pressing the key combination `CTRL`+`SPACE`. The autocompletion is context-sensitive. For example, if activated within a unit specification for ezUnits it will offer a list of applicable units.

ezUnits

Besides completing a file name, a unit name, or the current command or variable 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 `SHIFT`+`CTRL`+`SPACE` or select the respective menu item (Cell/Show Template).

#### 2.2.5.1 Greek characters

Equipos tradicionalmente almacenados en valores 8-bit. Esto permite para un máximo de 256 caracteres diferentes. Todas las letras, números t y símbolos de control (final de transmisión, final de cadena, líneas y bordes para dibujar rectángulos para menús :etc_.) de cerca cualquier idioma puede caber dentro de ese límite.

Para muchos países, la página de código de 256 caracteres que han sido elegidos no incluyen cosas como letras griegas, por lo que, eso es utilizado frecuentemente en matemáticas. Para solucionar este tipo de limitación [Unicode] (https://home.unicode.org/) ha sido inventado: una codificación que hace que el texto inglés funcione como normal, pero para utilizar más que los 256 caracteres.

Maxima 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. WxMaxima provides a method of entering Greek characters using the keyboard:

- A Greek letter can be entered by pressing the `ESC` key and then starting to type the Greek characterâs name.
- Alternatively it can be entered by pressing `ESC`, one letter (or two for the Greek letter omicron) and `ESC` again. In this case the following letters are supported:

tecla | Letra griega | tecla | Letra griega | tecla | Letra griega |

|:—–:|:————:|:—–:|:————:|:—- :|:————:| | a | alfa | i | iota | r | rho | | b | beta | k | kappa | s | sigma | | g | gamma | l | lambda | t | tau | | d | delta | m | mu | u | upsilon | | e | épsilon | n | nu | f | phi | | z | zeta | x | xi | c | chi | | h | eta | om | ómicron | y | psi | | q | teta | p | pi | o | omega | | A | Alfa | I | Iota | R | Ro | | B | Beta | K | Kappa | S | Sigma | | G | Gamma | L | Lambda | T | Tau | | D | Delta | M | Mu | U | Upsilon | | E | Épsilon | N | Nu | P | Phi | | Z | Zeta | X | Xi | C | Chi | | H | Eta | Om | Ómicron | Y | Psi | | T | Teta | P | Pi | O | Omega |

Además puede utilizar la barra lateral de «Teclas griegas» para introducir las letras griegas.

##### 2.2.5.1.1 Attention: Lookalike characters

Several Latin letters look like the Greek letters, e.g. the Latin letter “A” and the Greek letter “Alpha”. Although they look identical, they are two different Unicode characters, represented by different Unicode code points (numbers).

This might be problematic, if you assign a value to the variable A and later use the Greek letter Alpha to do something with this variable, especially on printouts. For the Greek letter my (which is also used as prefix for micro) there are also two different Unicode code points.

The “Greek letters”-sidebar therefore has the option, that lookalike characters are not available (which can be changed using a right-click menu).

El mismo mecanismo también permite introducir algunos símbolos matemáticos adicionales:

keys to enter | mathematical symbol
--- | ---
hbar | Planckâs constant: a h with a horizontal bar above it
Hbar | a H with a horizontal bar above it
2 | squared
3 | to the power of three
/2 | 1/2
partial | partial sign (the d of dx/dt)
integral | integral sign
sq | square root
ii | imaginary
ee | element
in | in
impl implies | implies
inf | infinity
empty | empty
TB | big triangle right
tb | small triangle right
and | and
or | or
xor | xor
nand | nand
nor | nor
equiv | equivalent to
not | not
union | union
inter | intersection
subseteq | subset or equal
subset | subset
notsubseteq | not subset or equal
notsubset | not subset
approx | approximately
propto | proportional to
neq != /= or # | not equal to
+/- or pm | a plus/minus sign
<= or leq | equal or less than
>= or geq | equal or greater than
<< or ll | much less than
>> or gg | much greater than
qed | end of proof
nabla | a nabla operator
sum | sum sign
prod | product sign
exists | there exists sign
nexists | there is no sign
parallel | a parallel sign
perp | a perpendicular sign
leadsto | a leads to sign
-> | a right arrow
–> | a long right arrow

Puede utilizar también los «Símbolos» de la barra lateral para introducir estos símbolos matemáticos.

If a special symbol isnât in the list, it is possible to input arbitrary Unicode characters by pressing `ESC` [number of the character (hexadecimal)] `ESC`. Additionally the “symbols” sidebar has a right-click menu that allow to display a list of all available Unicode symbols one can add to this toolbar or to the worksheet.

`ESC` `6` `1` `ESC` therefore results in an `a`.

Please note that most of these symbols (notable exceptions are the logic symbols) do not have a special meaning in Maxima and therefore will be interpreted as ordinary characters. If Maxima is compiled using a Lisp that doesnât support Unicode characters they might cause an error message.

It may be the case that e.g. Greek characters or mathematical symbols are not included in the selected font, then they can not be displayed. To solve that problem, select other fonts (using: Edit -> Configure -> Style).

### 2.2.6 Unicode replacement

wxMaxima will replace several Unicode characters with their respective Maxima expressions, e.g. “Â²” with “^2”, “Â³” with “^3”, the square root sign with the function `sqrt()`, the (mathematical) Sigma sign (which is not the same Unicode character as the corresponding Greek letter) with `sum()`, etc.

### 2.2.7 Side Panes

Enlaces para las instrucciones de Maxima más importantes, cosas como un índice de contenido, ventanas con mensajes de depuración o un historial de las últimas instrucciones emitidas pueden ser accedidas utilizando los paneles laterales. Puede ser habilitados utilizando el menú de “Vistas”. Todos ellos pueden ser trasladas a otras localización dentro o fuera de la ventana de _wxMaxima. Otro de los paneles útiles es el que permite introducir letras griegas utilizando el ratón.

Ejemplo de diferentes paneles laterales

En el panal lateral de “table de contenido”, uno puede incrementar o decrementar un encabezado tan solo pulsando sobre la cabecera con el botón de ratón secundario y seleccionar el siguiente tipo de cabecera más alto o bajo.

Incrementa o decrementa cabeceras dentro del panel lateral TOC

### 2.2.8 MathML output

Several word processors and similar programs either recognize MathML input and automatically insert it as an editable 2D equation - or (like LibreOffice) have an equation editor that offers an âimport MathML from clipboardâ feature. Others support RTF maths. WxMaxima, therefore, offers several entries in the right-click menu.

### 2.2.9 Markdown support

WxMaxima offers a set of standard Markdown conventions that donât collide with mathematical notation. One of these elements is bullet lists.

    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

WxMaxima will recognize text starting with `>` chars as block quotes:

`Ordinary text > quote quote quote quote > quote quote quote quote > quote quote quote quote Ordinary text`

_WxMaxima_âs TeX and HTML output will also recognize `=>` and replace it by the corresponding Unicode sign:

`cogito => sum.`

Other symbols the HTML and TeX export will recognize are `<=` and `>=` for comparisons, a double-pointed double arrow (`<=>`), single-headed arrows (`<->`, `->` and `<-`) and `+/-` as the respective sign. For TeX output also `<<` and `>>` are recognized.

### 2.2.10 Hotkeys

Muchas teclas resaltadas pueden ser encontradas dentro del texto de los respectivos menús. Desde que son tomados actualmente desde el texto del menú y por lo tanto puede ser adaptados por las traducciones de wxMaxima para coincidir con las necesidades de los usuarios del teclado local, no lo documentamos aquí. Unas pocas teclas especiales o aliases, sin embargo , no están documentadas dentro de los menús:

- `CTRL`+`MAYÚS`+`SUPR` borra una celda completa.
- `CTRL`+`TAB` or `CTRL`+`SHIFT`+`TAB` triggers the auto-completion mechanism.
- `MAYÚS`+`ESPACIO` introduce un espacio sin ruptura.

### 2.2.11 Raw TeX in the TeX export

Si una celda de texto comienza con `TeX:` la exportación de TeX contiene el texto literal que continua el marcador `TeX:`. Utilizando esta característica permite al apunte del marcado TeX sin el cuaderno wxMaxima.

## 2.3 File Formats

El material desarrollado en una sesión wxMaxima puede ser almacenado para un posterior uso en cualquiera de estas tras maneras:

### 2.3.1 .mac

`.mac` files are ordinary text files that contain Maxima commands. They can be read using _Maxima_âs `batch()` or `load()` command or _wxMaxima_âs File/Batch File menu entry.

Un ejemplo se muestra debajo. `Quadratic.mac` define una función y posteriormente genera un tramado con `wxdraw2d()`. Posteriormente el contenido del archivo `Quadratic.mac` es representado y la función `f()` nueva definida es evaluada.

Cargando un archivo con `batch()`

Attention: Although the file `Quadratic.mac` has a usual Maxima extension (`.mac`), it can only be read by wxMaxima, since the command `wxdraw2d()` is a wxMaxima-extension to Maxima. (Command line) Maxima will ignore the unknown command `wxdraw2d()` and print it as output again.

You can be use `.mac` files for writing your own library of macros. But since they donât contain enough structural information they cannot be read back as a wxMaxima session.

### 2.3.2 .wxm

`.wxm` files contain the worksheet except for _Maxima_âs output. On Maxima versions >5.38 they can be read using _Maxima_âs `load()` 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 wxMaxima.

#### 2.3.2.1 File format of wxm files

Esto es tan solo un archivo de texto simple (puede abrirlo con un editor de texto), conteniendo el contenido de celda como algunos comentarios Maxima especial.

Comienza con el siguiente comentario:

`/* [wxMaxima batch file version 1] [ DO NOT EDIT BY HAND! ]*/ /* [ Created with wxMaxima version 24.02.2_DevelopmentSnapshot ] */`

Y entonces las celdas siguientes, codificados como comentarios Maxima, p.ej., una celda de sección:

    /* [wxMaxima: section start ]
    Title of the section
       [wxMaxima: section end   ] */

o (en una celda matemática la entrada es por supuesto no comentada afuera (la salida no es guardada en un archivo `wxm`)):

    /* [wxMaxima: input   start ] */
    f(x):=x^2+1$
    f(2);
    /* [wxMaxima: input   end   ] */

Imágenes están codificadas en base64 con el tipo de imagen como primera línea):

    /* [wxMaxima: image   start ]
    jpg
    [very chaotic looking character sequence]
       [wxMaxima: image   end   ] */

Un salto de página es tan solo una línea conteniendo:

    /* [wxMaxima: page break    ] */

Y las celdas encarpetadas marcadas por:

    /* [wxMaxima: fold    start ] */
    ...
    /* [wxMaxima: fold    end   ] */

### 2.3.3 .wxmx

Este archivo cuyo formato está basado en XML guarda la hoja de trabajo completa incluyendo cosas como el factor de zoom y el listado de vigía. Es el formato de archivo preferido.

#### 2.3.3.1 File format of wxmx files

A `wxmx`-file seems to be a binary format, but one can handle it with tools, which are included in your OS. It is a zip file, one can decompress it with `unzip` (maybe rename it before, so that is recognized by the unzip program of your OS). We do not use the compression function, just the possibility to merge several files into one file - images are already compressed and the rest is simple text (probably much smaller, than huge images, which are included).

It does contain the following files:

- `mimetype`: this file does contain the mimetype of wxMaxima files: `text/x-wxmathml`
- `format.txt`: a short description about wxMaxima and the wxmx file format
- Images (e.g. png, jpeg): inline plots which were produced in the wxMaxima session and included images.
- `content.xml`: a XML document, which contains the various cells of your document in XML format.

So, if something goes wrong, you can unzip a wxMaxima document (maybe rename it before to a `zip`-file), maybe make changes in the `content.xml` file with a text editor, or replace an broken image, zip the files again, probably rename the `zip` to a `wxmx`-file - and you get another modified `wxmx`-file.

## 2.4 Configuration options

Para algunas configuraciones comunes de variables wxMaxima ofrecen dos maneras de configurarlas:

- La caja de diálogo de configuración de abajo le permite modificar sus valores predeterminados para las sesiones actuales y subsecuentes.
- 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.

Configuración de wxMaxima 1

### 2.4.1 Default animation framerate

La tasa del marco de animación que se utiliza para animaciones nuevas se conserva dentro de la variable `wxanimate_framerate`. El valor inicial de esta variable contiene dentro una hoja de trabajo nueva que puede ser modificada utilizando el diálogo de configuración.

### 2.4.2 Default plot size for new maxima sessions

After the next start, plots embedded into the worksheet will be created with this size if the value of `wxplot_size` isnât changed by maxima.

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:

    wxdraw2d(
       explicit(
           x^2,
           x,-5,5
       )
    ), wxplot_size=[480,480]$

### 2.4.3 Match parenthesis in text controls

Esta opción habilita dos cosas:

- If an opening parenthesis, bracket, or double quote is entered wxMaxima will insert a closing one after it.
- Si el texto está seleccionad si cualquiera de estas teclas es pulsada el texto seleccionado será puedes entre los signos coincidan.

### 2.4.4 Donât save the worksheet automatically

Si esta opción está puesta, el archivo donde la hoja de trabajo será sobrescrita solamente al solicitar el usuario. En caso de un cuelgue/corte de luz/… sin embargo, aún está disponible una copia de respaldo reciente dentro del directorio temporal ‘temp’.

If this option isnât set wxMaxima behaves more like a modern cellphone app:

- Ficheros son guardados automáticamente al salir
- And the file will automatically be saved every 3 minutes.

### 2.4.5 Where is the configuration saved?

If you are using Unix/Linux, the configuration information will be saved in a file `.wxMaxima` in your home directory (if you are using wxWidgets < 3.1.1), or `.config/wxMaxima.conf` ((XDG-Standard) if wxWidgets >= 3.1.1 is used). You can retrieve the wxWidgets version from the command `wxbuild_info();` or by using the menu option Help->About. wxWidgets is the cross-platform GUI library, which is the base for wxMaxima (therefore the `wx` in the name). (Since the filename starts with a dot, `.wxMaxima` or `.config` will be hidden).

Si está utilizando Windows, la configuración será almacenada dentro del registro. Encontrará los apuntes para wxMaxima en la posición siguiente dentro del registro: `HKEY_CURRENT_USER\Software\wxMaxima`

# 3 Extensions to Maxima

WxMaxima is primarily a graphical user interface for Maxima. As such, its main purpose is to pass along commands to Maxima and to report the results of executing those commands. In some cases, however, wxMaxima adds functionality to Maxima. _WxMaxima_â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 wxMaxima enhances the inclusion of graphics in a session.

## 3.1 Subscripted variables

Especificidades `wxsubscripts`, si (y como) wxMaxima auto-suscribirá nombres de variable:

Si es falso, la funcionalidad está apagada, wxMaxima no auto-suscribirá parte de nombres de variable tras un subrayado.

Si está fijado a `all`, todo será escrito debajo tras un guion bajo (_).

Si está fijado a `true` (verdadero) los nombres de variables del formato `x_y` están representados utilizando un subguion ‘if’

- Either `x` or `y` is a single letter or
- `y` is an integer (can include more than one character).

Como variables son auto-suscritas utilizando wxsubscripts

If the variable name doesnât match these requirements, it can still be declared as “to be subscripted” using the command `wxdeclare_subscript(variable_name);` or `wxdeclare_subscript([variable_name1,variable_name2,...]);` Declaring a variable as subscripted can be reverted using the following command: `wxdeclare_subscript(variable_name,false);`

You can use the menu “View->Autosubscript” to set these values.

## 3.2 User feedback in the status bar

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 Maxima is finished. It is safe to use `wxstatusbar()` even in libraries that might be used with plain Maxima (as opposed to wxMaxima): If wxMaxima isnât present the `wxstatusbar()` command will just be left unevaluated.

    for i:1 thru 10 do (
        /* Tell the user how far we got */
        wxstatusbar(concat("Pass ",i)),
        /* (sleep n) is a Lisp function, which can be used */
        /* with the character "?" before. It delays the */
        /* program execution (here: for 3 seconds) */
        ?sleep(3)
    )$

## 3.3 Plotting

Tramar (teniendo fundamentalmente hacerlo con gráficas) es un lugar donde un interfaz gráfico del usuario tendrá para proporcionar algunas extensiones para el programa original.

### 3.3.1 Embedding a plot into the worksheet

Maxima normally instructs the external program Gnuplot to open a separate window for every diagram it creates. Since many times it is convenient to embed graphs into the worksheet instead wxMaxima provides its own set of plot functions that donât differ from the corresponding maxima functions save in their name: They are all prefixed by a âwxâ.

Las siguientes funciones de tramado tienen contrapartes wx:

wxMaximaâs plot function | Maximaâs plot function
--- | ---
`wxplot2d()` | plot2d
`wxplot3d()` | plot3d
`wxdraw2d()` | draw2d
`wxdraw3d()` | draw2d
`wxdraw()` | draw
`wximplicit_plot()` | implicit_plot
`wxhistogram()` | histogram
`wxscatterplot()` | scatterplot
`wxbarsplot()` | barsplot
`wxpiechart()` | piechart
`wxboxplot()` | boxplot

Si un archivo de `wxm` es leído por (consola) Maxima, estas funciones son ignoradas (y escritas como salida, como otras funciones desconocidas en Maxima).

If you got problems with one of these functions, please check, if the problem exists in the the Maxima function too (e.g. you got an error with `wxplot2d()`, check the same plot in the Maxima command `plot2d()` (which opens the plot in a separate Window)). If the problem does not disappear, it is most likely a Maxima issue and should be reported in the Maxima bugtracker. Or maybe a Gnuplot issue.

### 3.3.2 Making embedded plots bigger or smaller

Tal como notó arriba, el dialogo de configuración proporciona una manera de modificar el tamaño de trama predeterminada lo cual fija el valor de inicio de `wxplot_size`. Las rutinas de tramado de wxMaxima respeta esta variable que especifica el tamaño de una trama en píxeles. Siempre puede ser solicitado o utilizado para fijar el tamaño de las tramas siguientes:

    wxplot_size:[1200,800]$
    wxdraw2d(
        explicit(
            sin(x),
            x,1,10
        )
    )$

Si el tamaño de solamente una trama va a ser modificada, Maxima proporciona una manera canónica para modificar un atributo solamente para la celda actual. En este uso la especificación `wxplot_size = [valor1, valor2]` es agregada a la instrucción `wxdraw2d( )`, y no es parte de la instrucción `wxdraw2d`.

    wxdraw2d(
        explicit(
            sin(x),
            x,1,10
        )
    ),wxplot_size=[1600,800]$

Estableciendo el tamaño de trazas empotradas con `wxplot_size` funciona para trazos empotrados utilizando p.e. instrucciones `wxplot`, `wxdraw`, `wxcontour_plot` y `wximplicit_plot` y para animaciones empotradas con instrucciones `with_slider_draw` y `wxanimate`.

### 3.3.3 Better quality plots

Gnuplot 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 Gnuplot is compiled to use this library the pngCairo option from the configuration menu (that can be overridden by the variable `wxplot_pngcairo`) enables support for antialiasing and additional line styles. If `wxplot_pngCairo` is set without Gnuplot supporting this the result will be error messages instead of graphics.

### 3.3.4 Opening embedded plots in interactive Gnuplot windows

If a plot was generated using the `wxdraw`-type commands (`wxplot2d` and `wxplot3d` isnât supported by this feature) and the file size of the underlying Gnuplot project isnât way too high wxMaxima offers a right-click menu that allows to open the plot in an interactive Gnuplot window.

### 3.3.5 Opening Gnuplotâs command console in `plot` windows

On MS Windows, there are two Gnuplot programs, `gnuplot.exe` and `wgnuplot.exe`. You can configure, which command should be used using the configuration menu. `wgnuplot.exe` offers the possibility to open a console window, where gnuplot commands can be entered into, `gnuplot.exe` does not offer this possibility. Unfortunately, `wgnuplot.exe` causes Gnuplot to “steal” the keyboard focus for a short time every time a plot is prepared.

### 3.3.6 Embedding animations into the spreadsheet

Diagramas 3D tienden hacerlo difícil para lectura de datos cuantitativos. Una alternativa viable sería asignar el 3er parámetro a la rueda del ratón. La instrucción `with_slider_draw` es una versión de `wxdraw2d` que prepara múltiples tramados y permite conmutar entre ellos moviendo el arrastre en la cima de la pantalla. wxMaxima permite exportar esta animación como un gif animado.

Los primeros dos argumentos para `with_slider_draw` son el nombre de la variable que está pasada entre las tramas y un listado de los valores de estas variables. Los argumentos que siguen son los argumentos ordinarios para `wxdraw2d`:

    with_slider_draw(
        f,[1,2,3,4,5,6,7,10],
        title=concat("f=",f,"Hz"),
        explicit(
            sin(2*%pi*f*x),
            x,0,1
        ),grid=true
    );

La misma funcionalidad para tramas de 3D es accesible como ‘with_slider:draw3d’, el cual permite rotación en tramas de 3D:

    wxanimate_autoplay:true;
    wxanimate_framerate:20;
    with_slider_draw3d(
        Î±,makelist(i,i,1,360,3),
        title=sconcat("Î±=",Î±),
        surface_hide=true,
        contour=both,
        view=[60,Î±],
        explicit(
            sin(x)*sin(y),
            x,-Ï,Ï,
            y,-Ï,Ï
        )
    )$

Si el formato general de la trama es que pasa quizá sufra mover el tramado tan solo un pequeño bit con el fin de crear su naturaleza 3D disponible a la intuición:

    wxanimate_autoplay:true;
    wxanimate_framerate:20;
    with_slider_draw3d(
        t,makelist(i,i,0,2*Ï,.05*Ï),
        title=sconcat("Î±=",Î±),
        surface_hide=true,
        contour=both,
        view=[60,30+5*sin(t)],
        explicit(
            sin(x)*y^2,
            x,-2*Ï,2*Ï,
            y,-2*Ï,2*Ï
        )
    )$

Para aquello más familiar con `trama` en vez de `dibujo`, hay un segundo conjunto de funciones:

- `with_slider` and
- `wxanimate`.

Normalmente las animaciones son retro-reproducidas o exportadas con la parte de marco elegida dentro de la configuración de wxMaxima. Para establecer la velocidad se reproduce una animación individual de vuelta a la variable `wxanimate_framerate` puede utilizarse:

    wxanimate(a, 10,
        sin(a*x), [x,-5,5]), wxanimate_framerate=6$

The animation functions use _Maxima_âs `makelist` command and therefore share 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:

    f:sin(a*x);
    with_slider_draw(
        a,makelist(i/2,i,1,10),
        title=concat("a=",float(a)),
        grid=true,
        explicit(f,x,0,10)
    )$

If Maxima is explicitly asked to substitute the sliderâs value plotting works fine instead:

    f:sin(a*x);
    with_slider_draw(
        b,makelist(i/2,i,1,10),
        title=concat("a=",float(b)),
        grid=true,
        explicit(
            subst(a=b,f),
            x,0,10
        )
    )$

### 3.3.7 Opening multiple plots in contemporaneous windows

Mientras no sean proporcionados por wxMaxima esta característica de Maxima (sobre configuraciones que la admitan) algunas veces vienen manualmente. Los siguientes ejemplos vienen desde una carta desde Mario Rodríguez al listado de correo de Maxima:

```maxima load(draw);

/* Parabola in window #1 */ draw2d(terminal=[wxt,1],explicit(x^2,x,-1,1));

/* Parabola in window #2 */ draw2d(terminal=[wxt,2],explicit(x^2,x,-1,1));

/* Paraboloid in window #3 */ draw3d(terminal=[wxt,3],explicit(x2+y2,x,-1,1,y,-1,1)); ```

Plotting multiple plots in the same window is possible, too (the same is possible in command line Maxima with the standard `draw()` command):

    wxdraw(
      gr2d(
        key="sin (x)",grid=[2,2],
        explicit(sin(x),x,0,2*%pi)),
      gr2d(
        key="cos (x)",grid=[2,2],
        explicit(cos(x),x,0,2*%pi))
    );

### 3.3.8 The “Plot using draw” side pane

La barra lateral «Tramado utilizando dibujo» oculta un generador de código simple que permite generar escenas que hagan uso de alguna de la flexibilidad del paquete draw con el que maxima viene.

#### 3.3.8.1 2D

Generates the skeleton of a `draw()` 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.

La característica de ayuda del botón 2D es que permite configurar la escena como una animación en la cual una variable (por defecto es t) tiene un valor diferente dentro de cada marco: a menudo un movimiento de trama 2D permite una interpretación más fácil que el de datos dentro de uno sin movimiento 3D.

#### 3.3.8.2 3D

Genera el esqueleto de una instrucción `draw()` que dibuja una escena 3D. Si no está configurada ninguna escena 2D o 3D, todo de los otros botones configuran una escena 2D que contenga la instrucción que el botón genera.

#### 3.3.8.3 Expression

Adjunta una trama común de una expresión como `sin(x)`, `x*sin(x)` o `x^2+2*x-4` para la instrucción `draw()` el cursor actualmente está dentro. Si no hay ninguna instrucción de dibujo en una escena 2D con la trama es generada. Cada escena puede ser completada con cualquier número de tramas.

#### 3.3.8.4 Implicit plot

Intenta encontrar todos los puntos como una expresión `y=sin(x)`, `y*sin(x)=3` o `x^2+y^2=4` es verdadero y trama de la curva resultante dentro de la instrucción `draw()` el cursor actualmente está dentro. Si no hay instrucción de dibujo en escena de 2D con el trama es generado.

#### 3.3.8.5 Parametric plot

Para un paso de una variable desde un límite inferior a un límite superior y utiliza dos expresiones como `t*sin(t)` y `t*cos(t)` para generar coordenadas x, y (y en tramas 3D también z) de una curva que es puesta dentro de la instrucción de actual del dibujo.

#### 3.3.8.6 Points

Dibuja muchos puntos que pueden ser unidos opcionalmente. Las coordenadas de los puntos son tomados desde un listado de listas, una unimatriz 2D o un listado o unimatriz por cada eje.

#### 3.3.8.7 Diagram title

Dibuja un título sobre el final superior del diagrama,

#### 3.3.8.8 Axis

Establece los ejes.

#### 3.3.8.9 Contour

(Solo para tramas 3D): agrega líneas de contorno similares a los que puedan ser encontrados dentro de una asociación de una montaña a la trama de instrucciones que continúe dentro de la instrucción ‘draw()’ actual y/o al plano de tierra del diagrama. Alternativamente, este asistente permite descartar el dibujo de las curvas completamente.

#### 3.3.8.10 Plot name

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.

#### 3.3.8.11 Line colour

Establece el color de línea para las tramas seguidas que contiene la instrucción de dibujo actual.

#### 3.3.8.12 Fill colour

Establece un color de relleno para tramas seguidas que contiene la instrucción de dibujo actual.

#### 3.3.8.13 Grid

Aparece un asistente que permite establecer las líneas de rejilla.

#### 3.3.8.14 Accuracy

Permite seleccionar un punto adecuado dentro de la velocidad versus exactitud compensada que es parte de cualquier programa de trama.

### 3.3.9 Modify font and font size for plots

Especially when you use a high resolution display, the default font size might be very small. For the `draw`-based commands, you can set the font / font size using options like `font=...`, `font_size=...`, e.g.:

    wxdraw2d(
         font="Helvetica",
         font_size=30,
         explicit(sin(x),x,1,10));

For the `plot`-commands (e.g. `wxplot2d`, `wxplot3d`) font sizes and fonts can be set using the `gnuplot_preamble` command, e.g.:

    wxplot2d(sin(x),[x,1,10],
             [gnuplot_preamble, "set tics font \"Arial, 30\"; set xlabel font \",20\"; set ylabel font \",20\";"]);

This sets the font for the numbers to Arial with size 30, the size for the xlabel and ylabel font to 20 (with the default font).

Read the Maxima and Gnuplot documentation for further information. Note: Gnuplot seems to have issues with larger font sizes, see wxMaxima issue 1966.

## 3.4 Embedding graphics

If the `.wxmx` file format is being used embedding files in a wxMaxima 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:

`maxima show_image("man.png");`

## 3.5 Startup files

El diálogo de configuración de wxMaxima ofrece editar dos archivos con instrucciones que son ejecutadas al inicializar:

- Un fichero que contenga instrucciones que estén ejecutadas al iniciar Maxima: «maxima-init.mac»
- one file of additional commands that are executed if wxMaxima is starting Maxima: `wxmaxima-init.mac`

For example, if Gnuplot is installed in `/opt` (maybe on MacOS), you can add `gnuplot_command:"/opt/local/bin/gnuplot"$` (or `/opt/gnuplot/bin/gnuplot` or any other path) to these files.

These files are in the Maxima user directory (usually `%USERPROFILE%/maxima` in Windows, `$HOME/.maxima` otherwise). The location can be found out with the command: `maxima_userdir;`

## 3.6 Special variables wx…

- ‘wxsubscripts’ le dice a Maxima si debería convertir los nombres de variables que contengan un guión bajo (‘R_150’ o lo similar) en variables sub-guion. Vea ‘wxdeclare_subscript’ para detalles los cuales nombres de variables son convertidos automáticamente.
- `wxfilename`: esta variable contiene el nombre del fichero actualmente abierto en wxMaxima.
- `wxdirname`: This variable contains the name the directory, in which the file currently opened in wxMaxima is.
- `wxplot_pngcairo` tells whether wxMaxima tries to use _Gnuplot_âs pngcairo terminal that provides more line styles and a better overall graphics quality.
- `wxplot_size` define la resolución de tramas empotradas.
- `wxchangedir`: On most operating systems wxMaxima automatically sets _Maxima_âs working directory to the directory of the current file. This allows file I/O (e.g. by `read_matrix`) 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 `false` from the config dialogue.
- `wxanimate_framerate`: El número de marcos por segundo de las siguientes animaciones con las que tienen que ser representadas.
- `wxanimate_autoplay`: Reproduce automáticamente animaciones predeterminadamente?
- `wxmaximaversion`: Returns the version number of wxMaxima.
- `wxwidgetsversion`: Returns the wxWidgets version wxMaxima is using.

## 3.7 Pretty-printing 2D output

The function `table_form()` displays a 2D list in a form that is more readable than the output from _Maxima_â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.

    table_form(
        [
            [1,2],
            [3,4]
        ]
    )$

Como se muestra en el ejemplo siguiente, los listados que son ensamblados por la instrucción ‘table_form’ pueden ser creados antes que la instrucción sea ejecutada.

Un tercer ejemplo de tabla

Además, porque una matriz es un listado de listados, las matrices pueden convertirse a tablas de una aparición similar.

Otro ejemplo de tabla_formulario

## 3.8 Bug reporting

WxMaxima proporciona unas pocas funciones que obtenga información de comunicados de fallos acerca del sistema actual:

- `wxbuild_info()` gathers information about the currently running version of wxMaxima
- `wxbug_report()` informa cómo y donde archivar los gazapos

## 3.9 Marking output being drawn in red

_Maxima_âs `box()` command causes wxMaxima to print its argument with a red foreground, if the second argument to the command is the text `highlight`.

## 3.10 Output rendering.

With `set_display()` one can set, how wxMaxima will render the output.

`set_display('xml)` is the default value. Here Maxima speaks to wxMaxima using an (machine readable) XML-dialect (can be seen in the “Raw XML sidebar”) and outputs the resulting formulas nicely rendered, e.g. pretty Matrices, Square root signs, fractions, etc.

`set_display('ascii)` causes wxMaxima to output formulas as in command line Maxima - as ASCII-Art.

`set_display('none)` causes ‘one-line’ ASCII results - the same as the command line Maxima command `display2d:false;` does.

# 4 Help menu

WxMaximaâs help menu provides access to the Maxima and wxMaxima manual, tips, some example worksheets and in command line Maxima included demos (the `demo()` command).

Infórmese, que las demos escriben:

~~~ At the â_â prompt, type â;â and to proceed with the demonstration. ~~~

That is valid for command-line Maxima, however in wxMaxima by default it is necessary to continue the demonstration with: `CTRL`+`ENTER`

(That can be configured in the Configure->Worksheet->“Hotkeys for sending commands to Maxima” menu.)

# 5 Troubleshooting

## 5.1 Cannot connect to Maxima

Since Maxima (the program that does the actual mathematics) and wxMaxima (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 intercept some connections to the internet, too), but also blocks inter-process-communication inside the same computer. Note that since Maxima is being run by a Lisp processor the process communication that is blocked 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.

On Unix 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.

## 5.2 How to save data from a broken .wxmx file

Internally most modern XML-based formats are ordinary zip files. WxMaxima doesnât turn on compression, so the contents of `.wxmx` files can be viewed in any text editor.

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 the information that is stored inside it. This can be done when there is a 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 wxMaxima during saving detected that something went wrong there will be a `.wxmx~` file whose contents might help.

And even if there isnât such a file: The `.wxmx` file is a container format and the XML portion is stored uncompressed. It it is possible to rename the `.wxmx` file to a `.txt` file and to use a text editor to recover the XML portion of the fileâs contents (it starts with `<?xml version="1.0" encoding="UTF-8"?>` and ends with `</wxMaximaDocument>`. Before and after that text you will see some unreadable binary contents in the text editor).

Si un archivo de texto conteniendo solamente estos contenidos (p.ej. copiar y pegar este texto a un archivo nuevo) es guardado como un archivo terminando en `.xml`, wxMaxima conocerá como recuperar el texto desde el documento.

## 5.3 I want some debug info to be displayed on the screen before my command

has finished

Normalmente wxMaxima espera a la fórmula 2D completa para ser transferida antes que comenzar a configurar el conjunto del tipo. Esto guarda tiempo para crear muchos intentos para tipos de teclas para solo ecuación parcialmente completada. Hay una instrucción `disp`, por lo que, eso proporcionará salida de depuración inmediatamente y sin esperar a que la instrucción de Maxima finalice:

    for i:1 thru 10 do (
       disp(i),
       /* (sleep n) is a Lisp function, which can be used */
       /* with the character "?" before. It delays the */
       /* program execution (here: for 3 seconds) */
       ?sleep(3)
    )$

Alternativamente uno puede buscar la instrucción `wxstatusbar()` arriba.

## 5.4 Plotting only shows a closed empty envelope with an error message

Esto significa que wxMaxima no pudo leer el archivo Maxima que fue proporcionado a la instrucción Gnuplot para crear.

Las posibles razones de este error son:

- The plotting command is part of a third-party package like `implicit_plot` but this package was not loaded by _Maxima_âs `load()` command before trying to plot.
- Maxima tried to do something the currently installed version of Gnuplot isnât able to understand. In this case, a file ending in `.gnuplot` located in the directory, which _Maxima_âs variable `maxima_userdir` is pointing, contains the instructions from Maxima to Gnuplot. Most of the time, this fileâs contents therefore are helpful when debugging the problem.
- 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 the plot” checkbox in the configuration dialog and donât set `wxplot_pngcairo` to true from Maxima.
- Gnuplot didnât output a valid `.png` file.

## 5.5 Plotting an animation results in âerror: undefined variableâ

El valor de la variable desplazada por defecto únicamente es sustituido dentro de la expresión que está para ser tramado si es visible ahí. Utilizando una orden `subst` que sustituya la variable de arrastre dentro de la ecuación para tramar soluciones que resuelvan este problema. Al final de la sección Animaciones empotradas a la hoja de cálculo, puede consultar un ejemplo.

## 5.6 I lost cell content and undo doesnât remember

Hay funciones de deshacer separadas para operaciones de celdas y para modificaciones dentro de celdas tales que modifiquen son bajos que este a veces ocurran. Si no hay varios métodos para cubrir datos:

- WxMaxima 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.
- If you still have a way to find out what label Maxima has assigned to the cell just type in the cellâs label and its contents will reappear.
- If you donât: Donât panic. In the âViewâ menu there is a way to show a history pane that shows all Maxima commands that have been issued recently.
- Si nada más ayuda Maxima contiene una característica de reproducción:

`maxima playback();`

## 5.7 WxMaxima starts up with the message âMaxima process terminated.â

One possible reason is that Maxima cannot be found in the location that is set in the âMaximaâ tab of _wxMaxima_âs configuration dialog and therefore wonât run at all. Setting the path to a working Maxima binary should fix this problem.

## 5.8 Maxima is forever calculating and not responding to input

It is theoretically possible that wxMaxima doesnât realize that Maxima has finished calculating and therefore never gets informed it can send new data to Maxima. If this is the case âTrigger evaluationâ might resynchronize the two programs.

## 5.9 My SBCL-based Maxima runs out of memory

El compilador Lisp SBCL por defecto viene con un límite de memoria que lo permite ejecutar incluso en equipos de bajo nivel. Cuando compile un paquete de software grande como Lapack u ocupándose con listados extremadamente grandes de ecuaciones este límite tal vez sea demasiado bajo. Con el fin de extender los límites SBCL puede ser previsto con la línea del parámetro de instrucción `--dynamic-space-size` que indica a SBCL cuantos megabytes debería reservar. Una ventana SBCL de 32-bit puede reservar hasta 999 megabytes, una versión SBCL de 64-bit ejecutándose en Windows pude ser instruido para utilizar más que la cantidad de 1280 megabytes compilando las necesidades Lapack.

One way to provide Maxima (and thus SBCL) with command line parameters is the “Additional parameters for Maxima” field of _wxMaxima_âs configuration dialogue.

sbcl memory

## 5.10 Input sometimes is sluggish/ignoring keys on Ubuntu

La instalación del paquete «ibus-gtk» debería resolver este problema. Vea https://bugs.launchpad.net/ubuntu/+source/wxwidgets3.0/+bug/1421558) para los detalles.

## 5.11 WxMaxima halts when Maxima processes Greek characters or Umlauts

Si su Maxima está basado en SBCL las siguientes líneas tienen que ser agregadas a su `.sbclrc`:

`commonlisp (setf sb-impl::*default-external-format* :utf-8)`

La carpeta donde este archivo tiene que colocarse es específico del sistema e instalación. Pero cualquier Maxima basada en SBCL que ya ha evaluado una celda dentro de la sesión actual felizmente dirá donde puede ser encontrada tras obtener la instrucción siguiente:

`:lisp (sb-impl::userinit-pathname)`

## 5.12 Note concerning Wayland (recent Linux/BSD distributions)

Parecen ser emitidos con el Servidor de Pantalla Wayland y wxWidgets. WxMaxima puede ser afectado, p.ej. esas barras laterales no son movibles.

Puede o bien desactivar Wayland y utilizar X11 en su lugar (globalmente) o tan solo decir, que wxMaxima utilizaría el X Window System poniendo: `GDK_BACKEND=x11`

P.ej. inicia wxMaxima con:

`GDK_BACKEND=x11 wxmaxima`

## 5.13 Why is the integrated manual browser not offered on my Windows PC?

Either wxWidgets wasnât compiled with support for Microsoftâs webview2 or Microsoftâs webview2 isnât installed.

## 5.14 Why is the external manual browser not working on my Linux box?

The HTML browser might be a snap, flatpack or appimage version. All of these typically cannot access files that are installed on your local system. Another reason might be that maxima or wxMaxima is installed as a snap, flatpack or something else that doesnât give the host system access to its contents. A third reason might be that the maxima HTML manual isnât installed and the online one cannot be accessed.

## 5.15 Can I make wxMaxima output both image files and embedded plots at once?

The worksheet embeds `.png files. WxMaxima allows the user to specify where they should be generated:

    wxdraw2d(
        file_name="test",  /* extension .png automatically added */
        explicit(sin(x),x,1,10)
    );

Si es un formato diferente para ser utilizado, es más fácil generar las imágenes y después importarlas dentro de la hoja de trabajo de nuevo:

    load("draw");
    pngdraw(name,[contents]):=
    (
        draw(
            append(
                [
                    terminal=pngcairo,
                    dimensions=wxplot_size,
                    file_name=name
                ],
                contents
            )
        ),
        show_image(printf(false,"~a.png",name))
    );
    pngdraw2d(name,[contents]):=
        pngdraw(name,gr2d(contents));

    pngdraw2d("Test",
            explicit(sin(x),x,1,10)
    );

## 5.16 Can I set the aspect ratio of an embedded plot?

Use the variable `wxplot_size`:

    wxdraw2d(
        explicit(sin(x),x,1,10)
    ),wxplot_size=[1000,1000];

## 5.17 After upgrading to MacOS 13.1 plot and/or draw commands output error

messages like

`1 HIToolbox 0x00007ff80cd91726 _ZN15MenuBarInstance22EnsureAutoShowObserverEv + 102 2 HIToolbox 0x00007ff80cd912b8 _ZN15MenuBarInstance14EnableAutoShowEv + 52 3 HIToolbox 0x00007ff80cd35908 SetMenuBarObscured + 408 ...`

This might be an issue with the operating system. Disable the hiding of the menu bar (SystemSettings => Desktop & Dock => Menu Bar) might solve the issue. See wxMaxima issue #1746 for more information.

## 5.18 Logging

Log messages might be helpful to debug problems. WxMaxima can log many events. Most log entries will be helpful for developers, especially in case of problems or bugs. If you run a “Release”-Build, the log windows is not shown by default, if you run a development version, it is shown by default as a second window. You can enable and disable this window using the “View->Toggle log window” menu entry.

Messages are not ‘lost’, if the log window is not shown, if you select to show the log window later, you will see past log messages (if you did not clear the messages).

Such messages may be helpful, when you create bug reports (or trying to find a bug by yourself).

Log messages can (additionally) be printed to STDERR, when using the command line option “–logtostderr”. On Windows a separate text console will be opened, as a Windows GUI application does not have the standard IO connected.

# 6 FAQ

## 6.1 Is there a way to make more text fit on a LaTeX page?

Sí. Utilice el paquete “geometry” de LaTeX para especificar el tamaño de los bordes.

You can add the following line to the LaTeX preamble (for example by using the respective field in the config dialogue (“Export”->“Additional lines for the TeX preamble”), to set borders of 1cm):

`latex \usepackage[left=1cm,right=1cm,top=1cm,bottom=1cm]{geometry}`

## 6.2 Is there a dark mode?

Si wxWidgets es suficientemente nuevo wxMaxima automáticamente estará en modo oscuro si el resto del sistema operativo también lo está. La misma hoja de trabajo por defecto está equipada con un fondo brillante. Pero puede ser configurado de otras maneras. Alternativamente hay un apunte del menú para ‘Ver/Invertir brillo de la hoja de trabajo’ para convertir rápidamente la hoja de trabajo desde oscuro a claro y viceversa.

## 6.3 WxMaxima sometimes hangs for several seconds once in the first minute

WxMaxima delegates some big tasks like parsing _Maxima_âs >1000-page-manual to background tasks, which normally goes totally unnoticed. At the moment the result of such a task is needed, though, it is possible that wxMaxima needs to wait a couple of seconds before it can continue its work.

## 6.4 Especially when testing new locale settings, a message box “locale

âxx_YYâ can not be set” occurs

Aviso local

(The same problem can occur with other applications too). The translations seem okay after you click on âOKâ. WxMaxima does not only use its own translations but the translations of the wxWidgets framework too.

Estos locales quizá no sean presente dentro del sistema. En sistemas Ubuntu/Debian pueden ser generados utilizando: `dpkg-reconfigure locales`

## 6.5 How can I use symbols for real numbers, natural numbers (â, â), etc.?

You can find these symbols in the Unicode sidebar (search for âdouble-struck capitalâ). But the selected font must also support these symbols. If they do not display properly, select another font.

## 6.6 How can a Maxima script determine, if it is running under wxMaxima or

command line Maxima?

Si se utiliza wxMaxima, la variable `maxima_frontend` de Maxima está fijada a `wxmaxima`. La variable Maxima `maxima_frontend_version` contiene la versión de wxMaxima en este caso.

Si no ningún frontend es utilizado (está utilizando Maxima en línea de instrucción), estas variables son falsas.

# 7 Command-line arguments

Usualmente puede iniciar programas con un interfaz gráfico de usuario tan solo pulsando en un icono de escritorio o apunte de menú del escritorio. wxMaxima -si inició desde la línea de instrucción- aún proporciona algunos interruptores en línea de instrucción, sin embargo.

- ‘-v’ o ‘–version’: extrae la información de la versión
- ‘-h’ o ‘–help’: extrae un texto breve de ayuda
- `-o` u `--open=<cad>`: abre el nombre del archivo proporcionado como un argumento a este interruptor de línea de instrucción
- ‘-e’ o ‘–eval’: evalúa el archivo tras abrirlo.
- `-b` o `--batch`: si la línea de orden abre un archivo todas las celdas dentro de este archivo son evaluadas y el archivo es guardado después. Esto es por ejemplo útil si la sesión descrita dentro del archivo hace que Maxima genere archivos de salida. El guion de procesamiento será detenido si wxMaxima detecta que Maxima tiene un error de salida y lo detendrá si Maxima tiene una cuestión: las matemáticas es algo interactivo por naturaliza por lo que un proceso de guion libre de interacción no puede ser garantizado completamente.
- `--logtostdout`: Registra todos los mensajes de la barra lateral “mensajes de depuración” a ‘stderr’, también.
- `--pipe`: Conducto de mensajes desde ‘Maxima’ a ‘stdout’.
- `--exit-on-error`: Cierra el programa en cualquier error de ‘maxima’.
- `-f` o `--ini=<cad>`: Utiliza el archivo de ‘init’ que fue proporcionado como argumento a este intercambio de línea de instrucción.
- `-u`, `--use-version=<cad>`: Utiliza la `<cad>` de la versión de ‘maxima’.
- `-l`, `--lisp=<cad>`: Utiliza un compilador de ‘maxima’ compilado con Lisp `<cad>`.
- `-X`, `--extra-args=<cad>`: Permite especificar argumentos adicionales de “Maxima”
- `-m` o `--maxima=<cad>`: Permite especificar la ubicación del binario de maxima
- `--enableipc`: Permite que “Maxima” controle “wxMaxima” a través de comunicaciones de interprocesos. Utilice esa opción con cuidado.
- `--wxmathml-lisp=<cdn>`: Ubicación de wxMathML.lisp (si no es el empotrado sería utilizado, mayormente para desarrolladores).

En vez de un menos, algunos sistemas operativos tal vez utilicen un guion breve al frente de los conmutadores de línea de instrucciones.

# 8 About the program, contributing to wxMaxima

wxMaxima es principalmente desarrollado utilizando el lenguaje de programación C++ utilizando el marco de trabajo wxWidgets, como sistema de compilación utilizamos CMake, una parte pequeña escrita en Lisp. Puede contribuir al proyecto wxMaxima en https://github.com/wxMaxima-developers/wxmaxima, si tiene conocimiento de estos lenguajes de programación y desea ayudar y contribuir al proyecto de software libre de wxMaxima.

¡Pero no solamente los programadores son necesarios! Puede contribuir además a wxMaxima, si ayuda para mejorar la documentación, encontrar e informar defectos (y quizá repararlas), sugerir características nuevas, ayudar a traducir wxMaxima o el manual a su idioma (lea el README.md en el subdirectorio de idioma como wxMaxima y el manual puede ser traducido).

O responda preguntas de otros usuarios en el foro de debate.

El código fuente de wxMaxima está documentado utilizando Doxygen aquí.

El programa es casi autónomo, por tanto excepto para bibliotecas del sistema (y la biblioteca wxWidgets), ninguna dependencia externa (como archivos gráficos o la parte Lisp (el archivo `wxmathML.lisp`) es necesario, se incluyen estos archivos dentro del ejecutable.

If you are a developer, you might want to try out a modified `wxmathML.lisp`-file without recompiling everything, one can use the command line option `--wxmathml-lisp=<str>` to use another Lisp file, not the included one.