# 1 El manual del usuario de wxMaxima

WxMaxima es un interfaz gráfico del usuario (IGU) para el sistema algebraico de computación Maxima (CAS). WxMaxima le permite a uno utilizar todas las funciones de Maxima. Además, proporciona asistentes convenientes para acceder a las características más comúnmente utilizadas. Este manual describe alguna de las características que hacen de wxMaxima una de las IGU más populares para Maxima.

Logotipo wxMaxima

# 2 Introducción a wxMaxima

## 2.1 Maxima y wxMaxima

En el dominio de código abierto, los sistemas grandes están divididos normalmente en proyectos más pequeños que son más fáciles para manipular en grupos pequeños de desarrolladores. Por ejemplo un programa para el quemado del DVD consistirá de una herramienta de línea de instrucciones que actualmente quema el CD un interfaz gráfico de usuario que permite a los usuarios implementarlo sin tener que aprenderse todas las opciones de línea de instrucciones como complemento “enviar-a-CD” para una aplicación de gestión de archivos, para la función N “quemar a CD” de un reproductor de música y como el grabador de CD para una herramienta de respaldo DVD. Otra ventaja es que dividiendo una tarea grande en partes más pequeñas permite a los desarrolladores proporcionar varios interfaces de usuarios para el mismo programa.

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

Documentación extensiva para Maxima está disponible en Internet. Parte de esta documentación además está disponible en el menú de ayuda de wxMaxima. Pulsando la tecla Ayuda (en muchos sistemas la tecla `F1`) causa que la característica de contexto de ayuda distinguible de wxMaxima automáticamente vaya a la página del manual de Maxima para la instrucción en el cursor.

### 2.1.2 WxMaxima

WxMaxima es un interfaz gráfico de usuario que proporciona la funcionalidad y flexibilidad completa de Maxima. WxMaxima ofrece a los usuarios una pantalla gráfica y varias características que hacen trabajar más fácilmente con Maxima. Por ejemplo wxMaxima permite a uno exportar cualquier contenido de celdas (o, si eso es necesario, cualquier parte de una fórmula, también) como texto, como LaTeX o especificación MathML en una sola pulsación secundaria. Por cierto, puede exportarse un cuaderno completo, ya sea como un archivo HTML o como un archivo LaTeX. La documentación para wxMaxima, incluyendo los cuadernos para ilustrar aspectos de su uso, está por conexión al sitio web de wxMaxima, así como a través del menú de ayuda.

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 Cuaderno básico

Mucho de wxMaxima son auto-explicativos, pero algunos detalles requieren atención. Este sitio contiene un número de cuadernos que dirige varios aspectos de wxMaxima. Trabaja a lo largo de estos (particularmente el tutorial de «10 minutos (wx)Maxima») incrementará la familiaridad de uno con ambos del contenido de Maxima y el uso de wxMAxima para interactuar con Maxima. Este manual se concentra en describir aspectos de wxMaxima que no son como los evidentes y que tal vez no está cubierto dentro del material en línea.

### 2.2.1 La aproximación del cuaderno

Una de las muy pocas cosas que no están normalizadas en wxMaxima es que se organiza los datos para Maxima dentro de celdas que son evaluadas (la cual indica: envía a Maxima) solamente cuando solicita el usuario esto. Cuando una celda es evaluada, todas las instrucciones dentro de esa celda, y solamente esa celda, son evaluadas como un guion. (El enunciado precedente no es muy preciso: uno puede seleccionar un conjunto de celdas adyacentes y evaluarlas a la vez. Además, uno puede instruir a Maxima que evalúe todas las celdas dentro de un cuaderno en una pasada). La aproximación de _wxMaxima para enviar instrucciones para ejecutar tal vez se sienta poco familiar en el primer momento. Sin embargo, drásticamente trabaja fácilmente con documentos grandes (cuando el usuario no desea cada modificación para disparar automáticamente una re-evaluación completa del todo el documento). Además, esta aproximación es muy útil para depurar.

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

En la evaluación de los contenidos de celda de entrada la celda Maxima de entrada asigna una etiqueta a la entrada (por defecto muestra en rojo y reconocible por el `%i`) por el cual puede ser referenciado posteriormente dentro de la sesión wxMaxima. La salida que genera Maxima además obtiene una etiqueta que comience con `%o` y por defecto está oculta, excepto si el usuario asigna la salida un nombre. En este caso por defecto el etiquetado definido por el usuario está desplegado. El estilo `%o` de etiquetado Maxima auto-genera además será accesible, sin embargo.

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 Celdas

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 Cursores horizontales y verticales

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.

Que no es estándar es que wxMaxima proporciona flexibilidad para arrastrar-y-soltar definiendo dos tipos de cursores. wxMaxima conmutará entre ellos automáticamente cuando lo necesite:

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

Cuando arranque wxMaxima, solo verá el cursor horizontal parpadeando. Si inicia al teclear, automáticamente será creada una celda matemática y el cursor cambiará a una vertical usual (verá una flecha derecha como “petición”, tras ser evaluada la celda matemática (`CTRL`+`ENTRAR`), verá las etiquetas, p.ej. `(%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 Enviar celdas a “Maxima”

La instrucción dentro de una celda de código es ejecutada una vez pulsando `CTRL`+`ENTRAR`, `MAYÚS`+`ENTRAR` o la tecla `ENTRAR` en el teclado numérico. Lo predeterminado de wxMaxima es introducir instrucciones cuando se introduzca `CTRL`+`ENTRAR` o `MAYÚS`+`ENTRAR`, pero wxMaxima puede ser configurado para ejecutar instrucciones como respuesta al `ENTRAR`.

### 2.2.5 Instrucción con auto-completado

WxMaxima contiene una característica de auto-completado que es disparada a través del menú (Celda/Palabra Completa) o alternativamente pulsando la combinación de teclas `CTRL`+`ESPACIO`. El auto-completado distingue MAYÚS/minús. Por ejemplo si está activado dentro de una especificación unitaria para ezUnits ofrecerá un listado de unidades aplicables.

ezUnits

Al lado de completar un nombre de archivo, un nombre de unidad o la instrucción actual o el nombre de variable, el auto-completado es capas de mostrar una plantilla para muchas de las instrucciones iniciando el tipo (y significado) de los parámetros que este programa espera. Para activar esta característica presione `MAYÚS`+`CTRL`+`ESPACIO` o seleccione el ítem del menú respectivo (Celda/Mostrar plantilla).

#### 2.2.5.1 Caracteres griegos

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 permite Unicode si fue compilado utilizando un compilador Lisp que o bien admite Unicode o que no tomen en cuenta acerca de la codificación tipográfica. Al menos una de este par de condiciones debe ser cierta. wxMaxima proporciona un método de introducción de caracteres griegos utilizando el teclado:

- Puede introducir una tecla griega pulsando la tecla `ESC` y después pulsando la tecla del nombre del carácter griego.
- 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:

teclas a introd | símbolos matemáticos
--- | ---
barh | constante de Planck: una h con una barra a hor. sobre
barH | una H con una barra hor. por encima de ésta
2 | al cuadrado
3 | al cubo
/2 | 1/2
parcial | signo parcial (la d de dx/dt)
integral | signo integral
sq | raíz cuadrada
ii | imaginario
ee | elemento
in | en, dentro de
impl implies | implica
inf | infinito
empty | vacío
TB | triángulo derecho grande
tb | triángulo derecho pequeño
and | y
or | o
xor | ¬o
nand | ¬y
nor | ¬o
equiv | equivalente
not | no
union | unión
inter | intersección
subseteq | subconjunto o igual
subset | subconjunto
notsubseteq | no subconjunto o igual
notsubset | no subconjunto
approx | aproximadamente
propto | proporcional a
neq != /= o # | no igual a
+/- o pm | un signo suma/resta
<= o meq | igual o menor que
>= o Meq | igual o Mayor que
<< o ll | mucho menor que
>> o gg | mucho mayor que
equiv | equivalente a
qed | final de prueba
nabla | un operador nabla
sum | signo suma
prod | signo producto
exists | existe signo
nexists | no existe signo
parallel | un signo paralelo
perp | un signo perpendicular
leadsto | una cabecera de signo
-> | una flecha derecha
–> | una flecha derecha más grande

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

Si un símbolo especial no está dentro del listado, es posible introducir caracteres Unicode arbitrarios pulsando `ESC` [número del carácter (hexadecimal)] `ESC`. Adicionalmente los “símbolos” de barra lateral tiene un menú de pulsación secundaria que permite representar un listado de todos los símbolos Unicode disponibles uno puede añadir a esta barra de herramientas o para la hoja de trabajo.

`ESC` `6` `1` `ESC` por tanto los resultados en una `a`.

Note que muchos de estos símbolos (notablemente excepciones son los símbolos lógicos) no tiene un significado especial dentro de Maxima y por lo tanto serán interpretados como caracteres ordinarios. Si Maxima está compilado utilizando un Lisp que no admite caracteres Unicode quizá cause un mensaje de error.

Puede ser el caso que p.ej. caracteres griegos o símbolos matemáticos no estén incluidos dentro de la tipografía seleccionada, entonces puede no ser reproducibles. Para resolver ese problema, seleccione otras tipografías (utilizando: Editar→Configurar→Estilo).

### 2.2.6 Sustitución Unicode

wxMaxima sustituirá varios caracteres Unicode por sus expresiones respectivas de Maxima, p.ej. “²” por “^2”, “³” por “^3”, el signo de raíz cuadrada por la función `sqrt()`, el signo Sigma (matemático) el cual no es el mismo carácter Unicode como la letra griega correspondiente) por `sum()`, etc.

Unicode has several “common” fractions encoded as one Unicode code point: `¼, ½, ¾, ⅐, ⅑, ⅒, ⅓, ⅔, ⅕, ⅖, ⅗, ⅘, ⅙, ⅚, ⅛, ⅜, ⅝, ⅞`

wxMaxima will replace them with their Maxima representations, e.g `(1/4)` before the input is sent do Maxima. There are also `⅟`, which will be replaced by `1/` and `↉` (used in baseball), which will be replaced by `(0/3)`.

It is recommended to use Maxima code (not these Unicode code points) in input cells (Rationale: (a) it might be possible, that the used font for math input does not contain them; (b) if you save the document as `wxm`-file, it is usually readable by (command line) Maxima, but these changes will of course not work in command line Maxima); but they may occur, if you cut&paste a formula from another document.

### 2.2.7 Paneles Laterales

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 Salida MathML

Varios procesadores de palabras y programas similares o bien reconocen entradas de MathML y lo insertan automáticamente como una ecuación editable 2D - o bien (como LibreOffice 5.1) tiene un editor de ecuación que ofrece una característica “importar MathML desde portapapeles”. Otros admiten matemáticas RTF. WxMaxima por lo tanto ofrece varios apuntes dentro del menú a través de la pulsación secundaria del menú.

### 2.2.9 Asistente Markdown

WxMaxima ofrece un conjunto de convenciones de Markdown estándar que no colisione con la notación matemática. Una vez que estos elementos son listados de puntos.

    Texto ordinario
     * Un ítem, nivel 1 de sangrado
     * Otro ítem en nivel 1 de sangrado
       * Un ítem en un nivel de sangrado 2
       * Un segundo ítem en el nivel 2 de sangrado
     * Un tercer ítem en el nivel 1 del sangrado
    Texto ordinario

WxMaxima reconocerá texto iniciando con los caracteres `>` como entrecomillado de bloque:

`Texto ordinario > comilla comilla comilla > comilla comilla comilla > comilla comilla comilla Texto ordinario`

Las salidas de TeX y HTML de wxMaxima también reconocerán `=>` y lo reemplazarán por el signo correspondiente de Unicode:

`cogito => sum.`

Otros símbolos de exportación HTML y TeX reconocerán son `<=` y `>=` para comparaciones, una flecha doble doble-apuntada (`<=>`), flechas con cabecera única (`<->`, `->` y `<-`) y `+/-` como el signo respectivo. Para salida TeX además son reconocidos `<<` y `>>`.

### 2.2.10 Teclas rápidas

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.3 TeX crudo dentro de la exportación TeX

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.4 Formatos de Archivos

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

### 2.4.1 .mac

Los archivos `.mac` son archivos de texto ordinarios que contienen instrucciones de Maxima. Pueden ser leídos utilizando la instrucción `batch()` o `load()` de Maxima o un apunte del menú de archivo del «Archivo/Menú de archivo guion» de wxMaxima.

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.

Puede utilizar los archivos `.mac` para escribir su propia biblioteca de macros. Pero desde que no contengan suficiente información estructural no pueden releer como una sesión wxMaxima.

### 2.4.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. Well - mostly. Questions (like `asksign(x)`) are problematic, as the answer is written in the `.wxm` file (so that it can be suggested after loading), but that can Maxima not evaluate. You can prevent Maxima from asking questions by using `assume()` to declare some properties, Maxima wants to know.

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.4.2.1 Formato de archivo de archivos wxm

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:

`/* [archivo de guion wxMaxima versión 1] [ ¡NO LO EDITE A MANO! ]*/ /* [ Creado con wxMaxima versión 24.02.2_DevelopmentSnapshot ] */`

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

    /* [wxMaxima: inicio de sesión ]
    Título de la sección
       [wxMaxima: final de sección   ] */

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

    /* [wxMaxima: entrada   inicio ] */
    f(x):=x^2+1$
    f(2);
    /* [wxMaxima: entrada   final   ] */

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

    /* [wxMaxima: imagen  inicio ]
    jpg
    [vista de secuencia de caracteres muy caótica]
       [wxMaxima: imagen  final  ] */

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

    /* [wxMaxima: salto de página    ] */

Y las celdas encarpetadas marcadas por:

    /* [wxMaxima: carpeta    inicio ] */
    ...
    /* [wxMaxima: carpeta    final  ] */

### 2.4.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.4.3.1 Formato de archivo de archivos wxm

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.5 Opciones de configuración

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.5.1 Velocidad de cuadros de animación predeterminada

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.5.2 Tamaño de trama predet. para sesiones maxima nuevas

Tras el siguiente inicio, tramas empotradas a la hoja del trabajo será creada con este tamaño si el valor de `wxplot_size` no es modificado por maxima.

Con la intención de establecer el tamaño de trama de un grafo único solamente utilice la notación siguiente puede ser utilizada que fija un valor de variable solamente para una sola instrucción:

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

### 2.5.3 Coincide paréntesis en controles de texto

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.5.4 No guardar automáticamente la hoja de trabajo

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’.

Si esta opción no está fijada wxMaxima se comporta más como una app telefónica moderna:

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

### 2.5.5 ¿Donde está la configuración guardada?

Si está utilizando Unix/Linux, la información de la configuración será guardada dentro de un archivo `.wxMaxima` dentro de su directorio personal (si está utilizando wxWidgets < 3.1.1), o `.config/wxMaxima.conf`((XDG-Estandarizado) si wxWidgets ≥ 3.1.1). Puede obtener la versión de wxWidgets desde la instrucción `wxbuild_info();` o para utilizar la opción del menú Ayuda→Acerca de. wxWidgets es la biblioteca IGU de plataforma cruzada lo cual es la base para wxMaxima (por lo tanto el `wx` dentro del nombre). (Cuando el nombre del archivo comience con un punto, `.wxmaxima` o `.config` estarán ocultos).

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 Extensiones para Maxima

WxMaxima es primariamente un interfaz gráfico de usuario para Maxima. Por lo tanto, su propósito principal es enviar órdenes a Maxima y comunicar los resultados de ejecutar esas órdenes. En algunos casos, sin embargo, _wxMaxima agrega funcionalidades a Maxima. La capacidad de wxMaxima para generar informes exportando un contenido del cuaderno a HTML y LaTeX ha sido mencionado. Esta sección considera algunas maneras que wxMaxima mejora la inclusión de gráficos dentro de una sesión.

## 3.1 Variables subescritas

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

Si el nombre de variable no coincide estos requerimientos, aún puede ser declarado como “para ser sub-guionado” utilizando la instrucción `wxdeclare_subscript(nombre_variable);` o `wxdeclare_subscript([nombre_variable1,nombre_variable2,...]);` declarando una variable como sub-guion puede ser revertido utilizando la instrucción siguiente: `wxdeclare_subscript(nombre_variable,false);`

Puede utilizar el menú «Vista→Auto-subguion» para fijar estos valores.

## 3.2 Comentario del usuario en la barra de estado

Las instrucciones de ejecución largas pueden proporcionar al usuario su estado dentro de la barra de estado. Esta comentario es sustituído por cualquier comentario devuelto que es colocada allí (permitiendo utilizarlo como un indicador de progreso) y es borrado tan pronto como la instrucción actual enviada a Maxima ha finalizado. Es seguro de utilizar `wxstatusbar()` incluso dentro de bibliotecas que tal vez sean utilizadas con el simple Maxima (como opuesto a wxMaxima): si wxMaxima no está presente la instrucción `wxstatusbar()` será tan solo dejada sin evaluar.

    for i:1 thru 10 do (
        /* Dice al usuario como de lejos obtuvo */
        wxstatusbar(concat("Pass ",i)),
        /* (sleep n) es una función Lisp, la cual puede utilizarse */
        /* con el carácter "?" antes. Retarda el */
        /* la ejecución del programa (aquí: para 3 segundos) */
        ?sleep(3)
    )$

## 3.3 Tramar

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 Empotrar una trama dentro de la hoja de trabajo

Maxima normalmente instrumenta el programa Gnuplot externo para abrir una ventana separada por cada diagrama que crea. Debido a que muchas veces es conveniente empotrar grafos a la hoja de trabajo en vez que wxMaxima proporcione su propio conjunto de funciones de trama que no difieran desde las funciones correspondientes a maxima que guarda dentro de su nombre: todo está prefijado por un “wx”.

Las siguientes funciones de tramado tienen contrapartes wx:

Función tramado wxMaxima | Función de plot de Maxima
--- | ---
`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 Creación de tramas empotradas más mayores o menores

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.4 Tramas de mayor calidad

Gnuplot parece no proporcionar una manera portable de determinar si admite bitmap de salida de calidad alta que la biblioteca Cairo proporciona. En los sistemas donde está compilado Gnuplot para utilizar esta biblioteca la opción pngCairo desde el menú de configuración (que puede ser sobrescrito por la variable `wxplot_pngcairo`) habilita el mantenimiento para antialias y estilos de línea adicional. Si `wxplot_pngCairo` está establecido sin Gnuplot admitiendo esto el resultado dará mensajes de error en vez de gráficos.

### 3.4.1 Abriendo tramados empotrados en ventanas Gnuplot interactivas

Si fue generada una trama utilizando las instrucciones de tipo `wxdraw` (`wxplot2d` y `wxplot3d` no son admitidas por esta característica) y el tamaño del archivo del proyecto Gnuplot subyacente no es una manera demasiado buena que wxMaxima ofrezca un menú de pulsación secundaria que permita abrir el tramado dentro de una ventana interactiva de Gnuplot.

### 3.4.2 Abrir consola para instrucciones Gnuplot en las ventanas `tramado`

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.4.3 Empotrar animaciones dentro de la hoja de cálculo

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$

Las funciones de animación utilizan las instrucciones `makelist` de Maxima y por lo tanto comparte el escollo que el valor de variable del arrastre se sustituye dentro de la expresión solamente si la variable es visible directamente dentro de la expresión. Por lo tanto el siguiente ejemplo fallará:

    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)
    )$

Si Maxima solicita explícitamente sustituir el valor del tramado deslizante funciona bien en su lugar:

    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.4.4 Abrir múltiples tramas en ventanas contemporáneas

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.4.5 El panel lateral «Tramado utilizando dibujo»

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.4.5.1 2D

Genera el esqueleto de una instrucción `draw()` que dibuja una escena 2D. Esta escena posterior tiene que ser completada con instrucciones que generan los contenidos de la escena, por ejemplo utilizando los botones dentro de las filas debajo del botón “2D”.

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.4.5.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.4.5.3 Expresión

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.4.5.4 Tramado implícito

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.4.5.5 Trama paramétrica

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.4.5.6 Puntos

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.4.5.7 Título del diagrama

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

#### 3.4.5.8 Axis

Establece los ejes.

#### 3.4.5.9 Contorno

(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.4.5.10 Nombre de trama

Agrega un apunte para leyenda mostrando el nombre del siguiente tramado de la leyenda del diagrama. Un nombre vacío deshabilita generando apuntes de leyenda para las tramas siguientes.

#### 3.4.5.11 Color de línea

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

#### 3.4.5.12 Color de relleno

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

#### 3.4.5.13 Grid

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

#### 3.4.5.14 Precisión

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

### 3.4.6 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.5 Gráficos empotrados

Si el formato de archivo `.wxmx` está siendo utilizado empotrando archivos dentro de un proyecto wxMaxima puede ser hecho como fácilmente como por arrastrar-y-soltar. Pero algunas veces (por ejemplo si el contenido de la imagen es modificado posteriormente sobre una sesión) es mejor decirle al archivo que cargue la imagen al evaluar:

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

## 3.6 Archivos de inicio

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.7 Variables especiales 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`: en la mayoría de los sistemas wxMaxima establece automáticamente el directorio de trabajo de Maxima al directorio del fichero actual. Esto permite la E/S del fichero (p.ej. a través de `read_matrix`) para trabajar sin especificar la ruta completa del fichero que tiene que ser leído o escrito. En Windows algunas veces esta característica causa mensajes de error y por lo tanto puede ser puesta a `false` desde el dialogo de configuración.
- `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.8 Salida de 2D con impresión bonita

La función `table_form()` representa un listado 2D dentro de un formulario que es más legible que la salida desde la rutina de salida predeterminada de Maxima. La entrada es un listado de uno o más listados. Como la instrucción “print”, esta instrucción representa la salida incluso cuando finalizó con signo de dólar. Finalifilledzando la instrucción con un resultado punto y coma devuelve el resultado en la misma tabla a lo largo con un enunciado “done”.

    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.9 Comunicar fallo

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.10 Marcar que la salida sea dibujada en rojo

La instrucción `box()` de Maxima causa que wxMaxima escriba su argumento con un fondo rojo, si el segundo argumento para la instrucción es el texto `resaltado`.

## 3.11 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 Menú de ayuda

El menú de ayuda de wxMaxima proporciona acceso para el manual de Maxima y wxMaxima, consejos, algunos ejemplos de hojas de trabajo y en la línea de instrucción de Maxima incluyó demos (la instrucción `demo()`).

Infórmese, que las demos escriben:

~~~ En la solicitud ’_’, teclee ’;’ y para proceder con la demostración. ~~~

Eso es válido para línea de instrucciones de Maxima, sin embargo en wxMaxima por defecto es necesario continuar la demostración con: `CTRL`+`ENTRAR`

(Eso puede ser configurado en el menú Configurar→Hoja de trabajo→“Teclas directas para enviar instrucciones a Maxima”.)

# 5 Solución de problemas

## 5.1 No se puede conectar a Maxima

Desde Maxima (el programa que hace las matemáticas actuales) y wxMaxima (proporcionando el interfaz de usuario de uso-fácil) con programas separados que se comunican por los medios de una conexión de red local. Por lo tanto la causa más probable es que esta conexión es algo que no funciona. Por ejemplo un cortafuegos pudo configurarse de una manera que no tan solo impida conexiones no autorizadas desde Internet (y quizá intercepta algunas conexiones de Internet, también), pero además bloquea la comunicación de inter-procesos dentro del mismo equipo. Nótese que desde Maxima se está ejecutando por un proceso Lisp la comunicación del proceso que está bloqueado desde unos no necesariamente tiene que ser nombrado como “maxima”. Los nombres comunes del programa que abre la conexión de red sería sbcl, gcl, ccl, lisp.exe o nombres similares.

En las máquinas Un*x otra razón posible sería que la red del bucle invertido que proporciona conexiones de red entre dos programas dentro del mismo equipo no está configurado apropiadamente.

## 5.2 Cómo guardar datos desde un archivo .wxmx defectuoso

Internamente muchos formatos modernos basados en XML están normalmente en archivos zip. WxMaxima no activa la compresión, por lo que el contenido de los archivos `.wxmx` pueden verse en cualquier editor de texto.

Si la firma zip en el final del archivo aún está intacta tras renombrar un archivo `.wxmx` estropeado a `.zip` muchos sistemas operativos proporcionarán una manera de extraer cualquier porción de información que esté almacenada dentro de ésta. Esto puede ser hecho cuando hay la necesitad de recuperar los archivos de imagen original desde un documento de procesamiento de texto. Si la firma zip no está intacta que no necesita estar el final del mundo: si wxMaxima al guardar ha detectado que algo es erróneo habrá un archivo `.wxmx~` cuyo contenido quizá ayude.

E incluso si no hay un archivo: el archivo `.wxmx` es un formato de contenedor y la porción XML es almacenada sin comprimir. Es posible renombrar el archivo `.wxmx` a un archivo `.txt` y utilizar un editor de texto para recuperar la porción XML del contenido del archivo (se inicia con `<?xml version="1.0" encoding="UTF-8"?>` y termina con `</wxMaximaDocument>`. Antes y después de ese texto verá algún contenido binario no legible dentro del editor del texto).

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 Deseo algo del informe de depuración para ser desplegada sobre la

pantalla antes de que mi instrucción haya finalizado

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) es una función de Lisp, la cual puede utilizarse */
       /* con el carácter "?" antes.  Retrasa la ejecución del */
       /* programa (aquí: por 3 segundos) */
       ?sleep(3)
    )$

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

## 5.4 El tramado solamente muestra una cobertura de sobre vacío cerrado con un

mensaje de error

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:

- La instrucción de tramado es parte de un paquete de tercera parte como ‘implicit_plot’ pero este paquete no fue cargado por la instrucción ‘load()’ de Maxima porque está intentando puntear.
- Maxima intentó hacer algo que la versión actualmente instalada de gnuplot no es capaz de entender. En este caso, un fichero terminando en `.gnuplot` localizado en el directorio, el cual la variable `maxima_userdir` está apuntando, contiene las instrucciones desde Maxima para gnuplot. La mayoría del tiempo, estos contenidos del fichero contiene por lo tanto ayuda cuando se depura el problema.
- Gnuplot fue instruido para utilizar la biblioteca pngcairo que proporciona antialias y estilos de líneas adicionales, pero no fue compilado para admitir esta posibilidad. Solución: Desmarque la casilla «Utilizar el terminal cairo para tramas» dentro del diálogo de configuración y no establezca `wxplot_pngcairo` a cierto desde Maxima.
- Gnuplot no saca un fichero «.png» válido.

## 5.5 Tramar una animación de resultados en «error: variable no definida»

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 He perdido el contenido de una celda y al deshacer no lo recuerda

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 actualmente tiene dos características de deshacer: el búfer de deshacer global que está activo si ninguna celda está seleccionada y un deshacer por celda que está activo si el cursor está dentro de una celda. Es peor intentar utilizar ambas opciones con el fin de ver si un valor anterior aún puede ser accedido.
- Si todavía tiene una manera de encontrar cual etiqueta de Maxima ha asignado a la celda tan solo teclee dentro de la etiqueta de la celda y sus contenidos aparecerán.
- Si no: no se asuste. En el menú “Vista” hay una manera de ver un panel histórico que muestra todas las instrucciones de Maxima que han sido emitidas recientemente.
- Si nada más ayuda Maxima contiene una característica de reproducción:

`maxima playback();`

## 5.7 WxMaxima arranca con el mensaje «Proceso de Maxima terminado.»

Una razón posible es que Maxima no puede ser encontrada dentro de la localización que está fijada dentro de la etiqueta “Maxima” del diálogo de configuración de wxMaxima y por lo tanto no ejecutará nada. Estableciendo la ruta a un Maxima binario para el trabajo debería solucionar este problema.

## 5.8 ‘Maxima’ está calculando para siempre y no responde a la entrada

Es posible teóricamente que wxMaxima no realiza que Maxima ha finalizado el cálculo y por lo tanto nunca está informado que puede enviar datos nuevos a Maxima. Si esto es el caso “Disparar evaluación” tal vez re-sincronice los dos programas.

## 5.9 Mi Maxima basada en SBCL se ejecuta fuera de la memoria

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.

Una manera de proporcionar a Maxima (y por lo tanto SBCL) con parámetros de línea de instrucción es el campo «Parámetros adicionales para Maxima» del diálogo de configuración de wxMaxima.

sbcl memory

## 5.10 Algunas veces las teclas de entrada son vagas/perezosas en 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 se detiene cuando Maxima procesa caracteres griegos o ümlaut

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 Nota concerniente a Wayland (distribuciones recientes de Linux/BSD)

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.12.1 ¿Por qué no es ofrecido el explorador manual integrado en mi PC Windows?

O bien wxWidgets no fueron compilados con mantenimiento para webview2 o webview2 de Microsoft no está instalado.

### 5.12.2 ¿Por qué el explorador manual externo no funciona en mi caja Linux?

El explorador HTML quizá es una versión de «snap», «flatpack» o «appimage». Todo de estos típicamente no puede acceder archivos que son instalados en su sistema local. Otra razón quizá sea que «maxima» o «wxMaxima» es instalado como un «snap», «flatpack» o algo más que no proporciona el acceso al sistema hospedante para sus contenidos. Una tercera razón sería que el manual HTML de maxima no está instalado y la conexión por línea no puede ser accedida.

### 5.12.3 ¿Se puede crear la salida de wxMaxima por ambos archivo de imagen y

tramas empotradas a la vez?

La hoja de trabajo empotra archivos .png. wxMaxima permite al usuario especificar donde serían generados:

    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.12.4 ¿Se puede establecer la proporción de aspecto de una trama?

Use the variable `wxplot_size`:

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

### 5.12.5 Tras mejorar a MacOS 13.1 los mensajes de error de salida para las

instrucciones de trama y/o dibujos como

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

Esto quizá sea un asunto con el sistema operativo. Desactive el oculto de la barra de menú (SystemSettings => Desktop & Dock => Menu Bar) tal vez resuelve el asunto. Consulte wxMaxima issue #1746 para más información.

## 5.13 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 ¿Hay una manera de crear más texto que quepa en una página LaTeX?

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

Puede agregar la línea siguiente al preámbulo LaTeX (por ejemplo utilizando el campo respectivo dentro del diálogo de configuración («Exportar» → «Líneas adicionales para el preámbulo TeX»), para fijar bordes de 1cm):

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

## 6.2 ¿Hay un modo oscuro?

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 algunas veces se cuelga durante varios segundos una vez en el

primer minuto

WxMaxima delega algunas tareas grandes como interpretar el manual de página >1000 de Maxima para tareas en segundo plano, lo cual normalmente va totalmente no comunicado. En el momento que el resultado de dicha tarea es necesaria, es posible que wxMaxima necesite esperar un par de segundos antes de poder continuar su trabajo.

## 6.4 Especialmente cuando pruebe parámetros locales nuevos, sucede una caja

con el mensaje “locale ’xx_YY’ no puede ser fijada”

Aviso local

(El mismo problema puede suceder con otras aplicaciones también). Los traslados parecen ok tras que pulse sobre ‘Aceptar’. Wxmaxima no solo utiliza su propias transacciones sino también las transacciones del marco de trabajo de wxWidgets.

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

## 6.5 ¿Cómo puedo utilizar símbolos para números reales, naturales (ℝ, ℕ),

etc.?

Puede encontrar estos símbolos en la barra lateral Unicode (busca ’doble-stuck capital’). Pero la tipografía seleccionada además debe mantener estos símbolos. Si no representan apropiadamente, seleccione otra tipografía.

## 6.6 ¿Cómo puede un guion Maxima determinar, si está ejecutándose bajo

wxMaxima o línea de instrucción de 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 Argumentos de línea de instrucción

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 Sobre el programa, contribuyendo a 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.

Si es un desarrollador, quizá desea intentar un archivo modificado de `wxmathML.lisp` sin tener que recompilar todo, uno puede utilizar la opción de línea de instrucción `--wxmathml-lisp=<str>` para utilizar otro archivo Lisp, no el incluido.