WxMaxima est une interface graphique (GUI) pour le système de calcul formel (CAS) Maxima. WxMaxima permet d’utiliser toutes les fonctions de Maxima. De plus, il fournit des assistants pratiques pour accéder aux fonctionnalités les plus couramment utilisées. Ce manuel décrit certaines des caractéristiques qui font de wxMaxima l’une des interfaces graphiques les plus populaires pour Maxima.
Dans le domaine open-source, les grands systèmes sont généralement divisés en projets plus petits, plus faciles à gérer pour de petits groupes de développeurs. Par exemple, un programme de gravure de CD peut se composer d’un outil en ligne de commande qui effectue réellement la gravure du CD, et d’une interface graphique permettant aux utilisateurs de l’utiliser sans avoir à apprendre toutes les options de la ligne de commande, voire sans jamais y recourir. Un avantage de cette méthode est que le travail de développement réalisé dans le programme en ligne de commande peut être partagé par de nombreuses applications : le même programme de gravure en ligne de commande peut servir de module “Envoyer vers un CD”, pour un gestionnaire de fichiers, de fonction “Graver sur CD” pour un lecteur multimédia, ou encore de graveur de CD pour un outil de sauvegarde sur DVD. Un autre avantage est que la division d’une tâche complexe en parties plus réduites permet aux développeurs de proposer plusieurs interfaces utilisateur pour un même programme.
Un système de calcul formel (CAS) comme Maxima s’intègre dans ce cadre. Un CAS peut fournir la logique derrière une application de type calculatrice à précision arbitraire ou effectuer des transformations automatiques de formules en arrière-plan d’un système plus large (par exemple, Sage). Alternativement, il peut être utilisé directement comme un logiciel autonome. Maxima peut être accessible via une ligne de commande. Cependant, une interface comme wxMaxima s’avère souvent un moyen plus efficace d’accéder au logiciel, surtout pour les nouveaux utilisateurs.
Maxima est un système complet de calcul formel (CAS). Un CAS est un programme capable de résoudre des problèmes mathématiques en manipulant des formules et en retournant des expressions algébriques qui résolvent le problème, plutôt que de simplement fournir une valeur numérique du résultat. Autrement dit, Maxima peut fonctionner comme une calculatrice qui donne des valeurs numériques des variables, mais il peut aussi fournir des solutions analytiques formelles. De plus, il propose une gamme de méthodes numériques pour analyser des équations ou des systèmes d’équations qui ne peuvent pas être résolus de manière formelle.
Une documentation complète pour Maxima est disponible en ligne. Une partie de cette documentation est également accessible via le menu d’aide de wxMaxima. En appuyant sur la touche d’aide (généralement la touche F1 sur la plupart des systèmes), la fonction d’aide contextuelle de wxMaxima ouvre automatiquement la page du manuel de Maxima correspondant à la commande située sous le curseur.
WxMaxima est une interface graphique qui offre toute les fonctionnalités et la flexibilité de Maxima. WxMaxima propose aux utilisateurs un affichage graphique ainsi que de nombreuses fonctionnalités qui facilitent l’utilisation de Maxima. Par exemple, wxMaxima permet d’exporter le contenu de n’importe quelle cellule (ou, si nécessaire, une partie d’une formule) sous forme de texte, de code LaTeX ou de codage MathML, simplement en effectuant un clic droit. En outre, un notebook entier peut être exporté, soit en tant que fichier HTML, soit en tant que fichier LaTeX. La documentation de wxMaxima, incluant des notebooks d’exemples illustrant ses différentes fonctionnalités, est disponible en ligne sur le site d’aide de wxMaxima, ainsi que via le menu d’aide.
Les calculs saisis dans wxMaxima sont exécutés en arrière-plan par l’outil en ligne de commande Maxima.
Une grande partie de wxMaxima est intuitive, mais certains détails nécessitent une attention particulière. Ce site contient plusieurs notebooks qui abordent divers aspects de wxMaxima. Parcourir certains d’entre eux (notamment le « tutoriel de 10 minutes sur (wx)Maxima ») permettra de mieux maîtriser à la fois le contenu de Maxima et l’utilisation de wxMaxima pour interagir avec Maxima. Ce manuel se concentre sur la description des aspects de wxMaxima qui ne sont pas nécessairement évidents et qui pourraient ne pas être présentés dans les ressources en ligne.
L’une des très rares choses qui ne sont pas standard avec wxMaxima est qu’il organise les données pour Maxima en cellules qui ne sont évaluées (c’est-à-dire envoyées à Maxima) que lorsque l’utilisateur le demande. Lorsqu’une cellule est évaluée, toutes les commandes de cette cellule, et uniquement de cette cellule, sont évaluées en bloc. (La phrase précédente n’est pas tout à fait exacte : on peut sélectionner un ensemble de cellules adjacentes et les évaluer ensemble. On peut aussi demander à Maxima d’évaluer toutes les cellules d’un notebook en une seule fois.) L’approche de wxMaxima pour exécuter les commandes peut sembler inhabituelle au premier abord. Elle facilite cependant grandement le travail avec de grands documents (où l’utilisateur ne souhaite pas que chaque modification déclenche automatiquement une réévaluation complète de l’ensemble du document). De plus, cette approche est très pratique pour le débogage.
Si du texte est saisi dans wxMaxima, une nouvelle cellule est automatiquement créée dans le notebook. Le type de cette cellule peut être sélectionné dans la barre d’outils. Si une cellule de code est créée, elle peut être envoyée à Maxima, ce qui affiche le résultat du calcul en dessous du code. Une paire de ce type de commandes est présentée ci-dessous.
Lors de l’évaluation du contenu d’une cellule d’entrée,
Maxima attribue un identifiant à l’entrée (affiché par défaut
en rouge et reconnaissable par le %i), ce qui permet d’y
faire référence plus tard dans la session wxMaxima. La sortie
générée par Maxima reçoit également un identifiant commençant
par %o, masqué par défaut, sauf si l’utilisateur attribue
un nom à cette sortie. Dans ce cas, l’identifiant défini par
l’utilisateur s’affiche par défaut, mais l’identifiant automatique de
type %o reste accessible.
Outre les cellules d’entrée, wxMaxima permet d’insérer des cellules de texte pour la documentation, des cellules d’image, des cellules de titre, de chapitre et de section. Chaque cellule dispose de son propre historique d’annulation, ce qui facilite le débogage en modifiant les valeurs de plusieurs cellules puis en annulant progressivement les changements inutiles. De plus, le notebook en lui-même possède un historique d’annulation global qui permet d’annuler les modifications, ajouts et suppressions de cellules.
La figure ci-dessous montre différents types de cellules (cellules de titre, cellules de section, cellules de sous-section, cellules de texte, cellules d’entrée/sortie et cellules d’image).
Le notebook est organisé en cellules. WxMaxima distingue les types de cellules suivants :
Par défaut, wxMaxima crée automatiquement une cellule de calcul lorsque du texte est saisi. Pour créer des cellules d’un autre type, utilisez le menu Cellule, les raccourcis clavier indiqués dans ce menu ou la liste déroulante de la barre d’outils. Une fois qu’une cellule non mathématique est créée, tout ce qui y est saisi est interprété comme du texte.
Un commentaire
(style C) peut être inséré dans une cellule de calcul comme suit :
/* Ce commentaire sera ignoré par Maxima */
“/*” indique le début du commentaire, “*/”
la fin.
Si l’utilisateur tente de sélectionner une phrase complète, un traitement de texte étendra automatiquement la sélection pour qu’elle commence et se termine aux limites d’un mot. De même, si plusieurs cellules sont sélectionnées, wxMaxima étendra la sélection aux cellules entières.
Ce qui est moins conventionnel, c’est que wxMaxima offre une facilité de glisser-déposer en définissant deux types de curseurs. wxMaxima basculera automatiquement entre eux selon le besoin :
Quand vous lancez wxMaxima, vous ne verrez que le curseur horizontal
clignotant. Si vous commencez à taper, une cellule mathématique sera
automatiquement créée et le curseur deviendra un curseur vertical
classique (vous verrez une flèche vers la droite comme “invite”, et
après avoir évalué la cellule mathématique
(CTRL+ENTRÉE), les étiquettes apparaîtront, par
exemple (%i1), (%o1).
Vous pourrez peut-être vouloir créer un type de cellule différent (via le menu “Cellule”), comme une cellule de titre ou une cellule de texte, pour décrire ce que vous allez faire lorsque vous commencerez à créer votre notebook.
Si vous naviguez entre les différentes cellules, vous verrez également le curseur horizontal (clignotant), indiquant l’endroit où vous pouvez insérer une nouvelle cellule dans votre notebook (soit une cellule mathématique, en commençant simplement à saisir votre formule, soit un autre type de cellule en utilisant le menu).
La commande dans une cellule de code est exécutée en appuyant une fois sur CTRL+ENTRÉE, MAJ+ENTRÉE ou la touche ENTRÉE du pavé numérique. Par défaut, wxMaxima exécute les commandes lorsque CTRL+ENTRÉE ou MAJ+ENTRÉE est pressé, mais il est possible de configurer wxMaxima pour qu’il exécute les commandes en réponse à la touche ENTRÉE.
wxMaxima dispose d’une fonction de complétion automatique, accessible via le menu (Cellule/Compléter le mot) ou en appuyant sur la combinaison de touches CTRL+ESPACE. Cette complétion est sensible au contexte : par exemple, si elle est activée lors d’une spécification d’unité pour ezUnits, elle proposera une liste des unités applicables.
Outre la complétion des noms de fichiers, d’unités, de commandes ou de variables, la complétion automatique peut aussi afficher un modèle pour la plupart des commandes, indiquant le type (et la signification) des paramètres attendus par le programme. Pour activer cette fonctionnalité, appuyez sur MAJ+CTRL+ESPACE ou sélectionnez l’option correspondante dans le menu (Cellule/Afficher le modèle).
Traditionnellement, les ordinateurs stockaient les caractères sur 8 bits, ce qui permet un maximum de 256 caractères différents. Toutes les lettres, chiffres et symboles de contrôle (fin de transmission, fin de chaîne, lignes et bordures pour dessiner des rectangles autour des menus, etc.) de presque n’importe quelle langue pouvaient tenir avec cette limite.
Pour la plupart des pays, la page de codes de 256 caractères choisie n’inclut cependant pas des éléments comme les lettres grecques, pourtant fréquemment utilisées en mathématiques. Pour surmonter ce type de limitation, Unicode a été inventé : il s’agit d’un encodage qui permet aux textes en anglais de s’afficher normalement, tout en utilisant bien plus que 256 caractères.
Maxima prend en charge Unicode s’il a été compilé avec un compilateur Lisp qui supporte Unicode ou qui ne tient pas compte de l’encodage de la police. Comme au moins une de ces deux conditions est probablement remplie, wxMaxima fournit une méthode pour saisir des caractères grecs à l’aide du clavier :
| touche | Lettre grecque | touche | Lettre grecque | touche | Lettre grecque |
|---|---|---|---|---|---|
| a | alpha | i | iota | r | rho |
| b | beta | k | kappa | s | sigma |
| g | gamma | l | lambda | t | tau |
| d | delta | m | mu | u | upsilon |
| e | epsilon | n | nu | f | phi |
| z | zeta | x | xi | c | chi |
| h | eta | om | omicron | y | psi |
| q | theta | p | pi | o | omega |
| A | Alpha | I | Iota | R | Rho |
| B | Beta | K | Kappa | S | Sigma |
| G | Gamma | L | Lambda | T | Tau |
| D | Delta | M | Mu | U | Upsilon |
| E | Epsilon | N | Nu | P | Phi |
| Z | Zeta | X | Xi | C | Chi |
| H | Eta | Om | Omicron | Y | Psi |
| T | Theta | P | Pi | O | Omega |
Vous pouvez également utiliser la barre latérale « Lettres grecques » pour insérer les lettres grecques.
Plusieurs lettres latines ressemblent aux lettres grecques, par exemple la lettre latine “A” et la lettre grecque “Alpha”. Bien qu’elles aient la même apparence, ce sont deux caractères Unicode distincts, représentés par des codages Unicode (nombres) différents.
Cela peut poser problème si vous attribuez une valeur à la variable A et que vous utilisez ensuite la lettre grecque Alpha pour faire quelque chose avec cette variable, notamment sur les impressions. Pour la lettre grecque mu (utilisée aussi comme préfixe pour micro), il existe également deux codages Unicode différents.
La barre latérale « Lettres grecques » offre donc l’option de désactiver les caractères similaires (ce paramètre peut être modifié via un menu accessible par un clic droit).
Le même mécanisme permet également de saisir divers symboles mathématiques :
| Touches à saisir | symbole mathématique |
|---|---|
| hbar | Constante de Planck : un h avec une barre horizontale au-dessus |
| Hbar | un H avec une barre horizontale au-dessus |
| 2 | au carré |
| 3 | à la puissance trois |
| /2 | 1/2 |
| partial | symbole de dérivation partielle (le d de dx/dt) |
| integral | symbole intégrale |
| sq | racine carrée |
| ii | imaginaire |
| ee | appartient à |
| in | dans |
| impl implies | implique |
| inf | infini |
| empty | ensemble vide |
| TB | grand triangle vers la droite |
| tb | petit triangle vers la droite |
| and | et |
| or | ou |
| xor | ou exclusif |
| nand | et non |
| nor | ni |
| equiv | équivalent à |
| not | non |
| union | union |
| inter | intersection |
| subseteq | sous-ensemble ou égal |
| subset | sous-ensemble |
| notsubseteq | n’est pas un sous-ensemble ou égal |
| notsubset | n’est pas un sous-ensemble |
| approx | approximativement |
| propto | proportionnel à |
| neq != /= ou # | différent de |
| +/- ou pm | signe plus/moins |
| <= ou leq | inférieur ou égal à |
| >= ou geq | supérieur ou égal à |
| << ou ll | beaucoup plus petit que |
| >> ou gg | beaucoup plus grand que |
| qed | fin de preuve |
| nabla | opérateur nabla |
| sum | symbole somme |
| prod | symbole produit |
| exists | il existe |
| nexists | il n’existe pas |
| parallel | symbole parallèle |
| perp | symbole perpendiculaire |
| leadsto | symbole mène à |
| -> | flèche vers la droite |
| –> | longue flèche vers la droite |
Vous pouvez aussi utiliser la barre latérale « Symboles » pour saisir ces symboles mathématiques.
Si un symbole spécial ne figure pas dans la liste, il est possible de saisir des caractères Unicode arbitraires en appuyant sur ÉCHAP [numéro du caractère (en hexadécimal)] ÉCHAP. De plus, la barre latérale « Symboles » dispose d’un menu accessible par un clic droit, qui permet d’afficher une liste de tous les symboles Unicode disponibles que l’on peut ajouter à cette barre d’outils ou insérer dans le notebook.
ESC61ESC est une séquence
qui produit un a.
Veuillez noter que la plupart de ces symboles (à l’exception notable des symboles logiques) n’ont pas de signification particulière dans Maxima et seront donc interprétés comme des caractères ordinaires. Si Maxima est compilé avec un Lisp qui ne supporte pas les caractères Unicode, ceux-ci peuvent provoquer un message d’erreur.
Il est possible que, par exemple, les caractères grecs ou les symboles mathématiques ne soient pas inclus dans la police sélectionnée et ne puissent donc pas s’afficher. Pour résoudre ce problème, choisissez une autre police (via : Édition -> Configurer -> Style).
wxMaxima remplacera plusieurs caractères Unicode par leurs
expressions Maxima correspondantes, par exemple « ² » par « ^2 », « ³ »
par « ^3 », le symbole de la racine carrée par la fonction
sqrt(), le symbole Sigma mathématique (qui n’est pas le
même caractère Unicode que la lettre grecque correspondante) par
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.
Les raccourcis vers les commandes les plus importantes de Maxima, comme une table des matières, des fenêtres avec des messages de débogage ou un historique des dernières commandes exécutées, peuvent être accessibles via les panneaux latéraux. Ceux-ci peuvent être activés depuis le menu « Affichage ». Ils peuvent tous être déplacés vers d’autres emplacements, à l’intérieur ou à l’extérieur de la fenêtre de wxMaxima. Un autre volet utile est celui qui permet de saisir des lettres grecques avec la souris.
Dans le volet latéral « table des matières », vous pouvez augmenter ou diminuer le niveau d’un titre en cliquant simplement dessus avec le bouton droit de la souris et en sélectionnant le niveau de titre supérieur ou inférieur.
Plusieurs logiciels de traitement de texte et programmes similaires reconnaissent soit une entrée MathML et l’insère automatiquement sous forme d’équation 2D modifiable, soit (comme LibreOffice) disposent d’un éditeur d’équations proposant une fonction « Importer du MathML depuis le presse-papiers ». D’autres prennent en charge les équations en RTF. WxMaxima offre donc plusieurs options dans le menu contextuel (clic droit).
WxMaxima propose un ensemble de balises Markdown standard qui n’entrent pas en conflit avec la notation mathématique. L’un de ces éléments est les listes à puces.
Texte ordinaire
* Un élément, niveau d'indentation 1
* Un autre élément au niveau d'indentation 1
* Un élément au deuxième niveau d'indentation
* Un deuxième élément au deuxième niveau d'indentation
* Un troisième élément au premier niveau d'indentation
Texte ordinaireWxMaxima reconnaîtra le texte commençant par le caractère
> comme des blocs de citations :
Texte ordinaire > citation citation citation citation > citation citation citation citation > citation citation citation citation Texte ordinaire
WxMaxima reconnaîtra => dans ses sorties TeX
et HTML et le remplacera par le symbole Unicode correspondant :
cogito => sum.
D’autres symboles reconnus par les exports HTML et TeX sont
<= et >= pour les comparaisons, une
double flèche à double pointe (<=>), des flèches à
une seule direction (<->, -> et
<-) ainsi que +/- pour le symbole
correspondant. Pour la sortie TeX, les symboles << et
>> sont également reconnus.
La plupart des raccourcis clavier peuvent être trouvés dans le texte des menus associés. Comme ils sont effectivement tirés du texte des menus, ils peuvent ainsi être personnalisés par les traductions de wxMaxima pour correspondre aux besoins des utilisateurs des claviers locaux, nous ne les documentons pas ici. Cependant, quelques raccourcis clavier ou alias de raccourcis ne sont pas documentés dans les menus :
Si une cellule de texte commence par TeX:, l’export TeX
inclut le texte littéral qui suit le marqueur TeX:. Cette
fonctionnalité permet d’insérer du code TeX directement dans le classeur
wxMaxima.
Le contenu développé lors d’une session wxMaxima peut être enregistré pour une utilisation ultérieure de trois manières différentes :
Les fichiers .mac sont des fichiers texte ordinaires qui
contiennent des commandes Maxima. Ils peuvent être lus à l’aide
de la commande batch() ou load() de
Maxima, ou via l’entrée de menu Fichier/Charger un packetage de
wxMaxima.
Un exemple est présenté ci-dessous. Quadratic.mac
définit une fonction, puis génère un tracé avec wxdraw2d().
Ensuite, le contenu du fichier Quadratic.mac est affiché et
la fonction nouvellement définie f() est évaluée.
Attention : Bien que le fichier Quadratic.mac ait
l’extension habituelle de Maxima (.mac), il ne
peut être lu que par wxMaxima, car la commande
wxdraw2d() est une extension de wxMaxima à Maxima.
Maxima en ligne de commande ignorera la commande inconnue
wxdraw2d() et l’affichera à l’identique en sortie.
Vous pouvez utiliser les fichiers .mac pour écrire votre
propre bibliothèque de macros. Cependant, comme ils ne contiennent pas
assez d’informations structurelles, ils ne peuvent pas être relus en
tant que session wxMaxima.
Les fichiers .wxm contiennent la feuille de travail, à
l’exception des sorties de Maxima. À partir des versions de
Maxima >5.38, ils peuvent être lus avec la fonction
load() de Maxima, tout comme les fichiers
.mac. Avec ce format en texte brut, il est parfois
inévitable que les feuilles de travail utilisant de nouvelles
fonctionnalités ne soient pas rétrocompatibles avec les anciennes
versions de wxMaxima.
Il s’agit simplement d’un fichier texte brut (vous pouvez l’ouvrir avec un éditeur de texte), contenant le contenu des cellules sous forme de commentaires spéciaux Maxima.
Cela commence par le commentaire suivant :
/* [wxMaxima batch file version 1] [ DO NOT EDIT BY HAND! ]*/ /* [ Created with wxMaxima version 24.02.2_DevelopmentSnapshot ] */
Puis les cellules suivent, encodées sous forme de commentaires Maxima, par exemple une cellule de section :
/* [wxMaxima: section start ]
Titre de la section
[wxMaxima: section end ] */ou (dans une cellule Math, l’entrée n’est bien sûr pas mise
en commentaire (la sortie n’est pas enregistrée dans un fichier
wxm)) :
/* [wxMaxima: input start ] */
f(x):=x^2+1$
f(2);
/* [wxMaxima: input end ] */Les images sont encodées en Base64 avec l’indication du type de l’image sur la première ligne):
/* [wxMaxima: image start ]
jpg
[séquence de caractères très chaotique à première vue]
[wxMaxima: image end ] */Une saut de page est simplement une ligne contenant :
/* [wxMaxima: page break ] */Et les cellules repliées sont marquées par :
/* [wxMaxima: fold start ] */
...
/* [wxMaxima: fold end ] */Ce format de fichier basé sur le XML enregistre la feuille de travail complète, y compris des éléments comme le facteur de zoom et la liste de suivi du notebook. C’est le format de fichier recommandé.
Un fichier wxmx semble être un format binaire, mais on
peut le gérer avec des outils inclus dans votre système d’exploitation.
Il s’agit d’un fichier zip, que l’on peut décompresser avec
unzip (peut-être faut-il le renommer au préalable pour
qu’il soit reconnu par le programme de décompression de votre OS). Nous
n’utilisons pas la fonction de compression, seulement la possibilité de
regrouper plusieurs fichiers en un seul — les images sont déjà
compressées et le reste est du texte simple (probablement bien plus
petit que les images volumineuses qu’il contient).
Il contient les fichiers suivants :
mimetype: this file does contain the mimetype of
wxMaxima files: text/x-wxmathmlformat.txt: a short description about wxMaxima and the
wxmx file formatcontent.xml: a XML document, which contains the various
cells of your document in XML format.Donc, si quelque chose ne va pas, vous pouvez décompresser un
document wxMaxima (peut-être en le renommant au préalable en
.zip), éventuellement modifier le fichier
content.xml avec un éditeur de texte ou remplacer une image
corrompue, recompresser les fichiers, probablement renommer le
.zip en .wxmx — et vous obtiendrez un autre
fichier wxmx modifié.
Pour certaines variables courantes liées à la configuration, wxMaxima propose deux méthodes de configuration :
La fréquence des images utilisée pour les nouvelles animations est
stockée dans la variable wxanimate_framerate. La valeur
initiale de cette variable dans un nouveau notebook peut être modifiée
via la boîte de dialogue de configuration.
maxima
Lors du prochain démarrage, les graphiques intégrés au notebook
seront créés avec ces dimensions, sauf si la valeur de
wxplot_size est modifiée par Maxima.
Afin de définir la taille d’un seul graphique, la notation suivante peut être utilisée afin d’affecter une valeur à une variable pour une seule commande :
wxdraw2d(
explicit(
x^2,
x,-5,5
)
), wxplot_size=[480,480]$Cette option active deux fonctionnalités :
Si cette option est activée, le fichier du notebook ne sera écrasé que sur demande de l’utilisateur. En cas de plantage, de coupure de courant ou autre incident, une copie de sauvegarde récente reste cependant disponible dans le dossier temporaire.
Si cette option n’est pas activée, wxMaxima se comporte davantage comme une application moderne de smartphone :
Si vous utilisez Unix/Linux, les informations de configuration sont
enregistrées dans un fichier .wxMaxima de votre répertoire
personnel (si vous utilisez wxWidgets < 3.1.1), ou dans
.config/wxMaxima.conf (norme XDG, si wxWidgets >= 3.1.1
est utilisé). Vous pouvez connaître la version de wxWidgets avec la
commande wxbuild_info(); ou via le menu Aide → À propos. wxWidgets est la bibliothèque
d’interface graphique multiplateforme sur laquelle repose
wxMaxima (d’où le wx dans le nom). (Ces fichiers
ou dossiers, commençant par un point, .wxMaxima ou
.config, sont donc des fichiers cachés).
Si vous utilisez Windows, la configuration est stockée dans le
registre. Vous trouverez les entrées pour wxMaxima à
l’emplacement suivant du registre :
HKEY_CURRENT_USER\Software\wxMaxima
WxMaxima est avant tout une interface graphique pour Maxima. Ainsi, son rôle principal consiste à transmettre les commandes à Maxima et à afficher les résultats de leur exécution. Cependant, WxMaxima ajoute également certaines fonctionnalités à Maxima. La capacité de WxMaxima à générer des rapports en exportant le contenu d’un notebook vers des fichiers HTML et LaTeX a déjà été évoquée. Cette section aborde certaines améliorations apportées par WxMaxima pour l’inclusion de graphiques dans une session.
wxsubscripts définit si (et comment) _wxMaxima
appliquera automatiquement des indices aux noms de variables :
Si sa valeur est false, cette fonctionnalité est
désactivée : wxMaxima ne transformera pas automatiquement en indices les
parties des noms de variables suivant un tiret bas.
Si elle est définie sur 'all, tout ce qui suit un tiret
bas sera converti en indice.
Si elle est définie sur true, les noms de variables au
format x_y s’affichent avec un indice uniquement si
x or y is a single letter ory is an integer (can include more than one
character).
Si le nom de la variable ne répond pas à ces exigences, il peut
toujours être déclaré comme « à mettre en indice » en utilisant la
commande wxdeclare_subscript(nom_variable); ou
wxdeclare_subscript([nom_variable1, nom_variable2, ...]);Une
déclaration de variable en tant qu’indice peut être annulée avec la
commande suivante :
wxdeclare_subscript(nom_variable, false);
Vous pouvez utiliser le menu “Affichage->Mise en indice automatique” pour définir ces valeurs.
Les commandes qui durent longtemps peuvent générer un message pour
l’utilisateur dans la barre d’état. Ce dernier est remplacé par tout
nouveau message qui apparait dans cette barre (ce qui permet de
l’utiliser comme indicateur de progression) et est supprimé dès que la
commande actuelle envoyée à Maxima est terminée. Il n’y a pas
de risque à utiliser wxstatusbar() même avec des
bibliothèques qui pourraient être utilisées avec Maxima
standard (par opposition à wxMaxima) : si wxMaxima
n’est pas présent, la commande wxstatusbar() restera
simplement non évaluée.
for i:1 thru 10 do (
/* Informe l'utilisateur de l'avancement. */
wxstatusbar(concat("Pass ",i)),
/* (sleep n) est une fonction Lisp, qui peut être utilisée */
/* avec le caractère "?" avant. Cela retarde */
/* l'exécution du programme (dans ce cas : pour 3 secondes) */
?sleep(3)
)$La création de courbes (qui repose fondamentalement sur des éléments graphiques) est un domaine où une interface utilisateur graphique devra apporter certaines extensions au programme d’origine.
Normalement, Maxima demande au programme externe Gnuplot d’ouvrir une fenêtre séparée pour chaque graphique qu’il génère. Comme il est souvent plus pratique d’intégrer les graphiques directement dans le notebook, wxMaxima propose son propre ensemble de fonctions graphiques. Celles-ci ne diffèrent des fonctions Maxima correspondantes que par leur nom : elles sont toutes préfixées par « wx ».
| wxMaximaâ fonction graphique | Maxima fonction graphique |
|---|---|
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 fichier .wxm est lu par Maxima (en mode
console), ces fonctions sont ignorées (et affichées à l’identique en
sortie, comme toute autre fonction inconnue dans 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.
Comme indiqué précédemment, la boîte de dialogue de configuration
permet de modifier la taille par défaut des graphiques créés, en
définissant la valeur initiale de wxplot_size. Les routines
graphiques de wxMaxima tiennent compte de cette variable, qui
spécifie la taille d’un graphique en pixels. Il est toujours possible
d’interroger ou de définir cette variable pour ajuster la taille des
graphiques suivants :
wxplot_size:[1200,800]$
wxdraw2d(
explicit(
sin(x),
x,1,10
)
)$Si la dimension d’un seul graphique doit être modifiée,
Maxima offre une méthode standard pour changer l’attribut de
taille uniquement pour la cellule actuelle. Dans ce cas, la
spécification wxplot_size = [valeur1, valeur2] est ajoutée
à la commande wxdraw2d(), sans faire partie intégrante de
cette commande.
wxdraw2d(
explicit(
sin(x),
x,1,10
)
),wxplot_size=[1600,800]$Le réglage de la taille des graphiques intégrés avec
wxplot_size fonctionne pour les graphiques en ligne
utilisant par exemple les commandes wxplot,
wxdraw, wxcontour_plot et
wximplicit_plot, ainsi que pour les animations intégrées
avec les commandes with_slider_draw et
wxanimate.
Il semble que Gnuplot ne propose pas de méthode portable
pour déterminer s’il prend en charge la sortie bitmap haute qualité
fournie par la bibliothèque Cairo. Sur les systèmes où Gnuplot
est compilé pour utiliser cette bibliothèque, l’option pngCairo du menu
de configuration (qui peut être écrasée par la variable
wxplot_pngcairo) active la prise en charge de
l’antialiasing et des styles de ligne supplémentaires. Si
wxplot_pngcairo est définie alors que Gnuplot ne
supporte pas cette fonctionnalité, le résultat résultera en des messages
d’erreur au lieu des graphiques.
Gnuplot
Si un graphique a été généré avec des commandes de type
wxdraw (wxplot2d et wxplot3d ne
sont pas pris en charge par cette fonctionnalité) et que la taille du
fichier du projet Gnuplot correspondant n’est pas trop élevée,
wxMaxima propose un menu contextuel (clic droit) permettant
d’ouvrir le graphique dans une fenêtre interactive Gnuplot.
plotSous MS Windows, il existe deux programmes Gnuplot :
gnuplot.exe et wgnuplot.exe. Vous pouvez
configurer lequel utiliser via le menu de configuration.
wgnuplot.exe permet d’ouvrir une fenêtre de console où les
commandes Gnuplot peuvent être saisies, ce que
gnuplot.exe ne propose pas. Malheureusement,
wgnuplot.exe provoque un bref “décrochage” du focus clavier
à chaque génération d’un graphique.
Les diagrammes en 3D impliquent souvent que la lecture des données
quantitatives soit difficile. Une alternative intéressante consiste à
associer le 3ᵉ paramètre à la molette de la souris. La commande
with_slider_draw est une version de wxdraw2d
qui génère plusieurs graphiques et permet de basculer entre eux à l’aide
d’un curseur situé en haut de l’écran. WxMaxima permet
d’exporter cette animation au format GIF animé.
Les deux premiers arguments de with_slider_draw sont le
nom du paramètre qui varie entre les graphiques et une liste des valeurs
prises par ce paramètre. Les arguments suivants sont les arguments
classiques de la commande 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 même fonctionnalité pour les graphiques 3D est accessible avec
with_slider_draw3d, qui permet de faire tourner les
graphiques 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 c’est plutôt la forme générale du graphique qui importe, un léger déplacement peut suffire pour rendre la visualisation 3D plus intuitive :
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*π
)
)$Pour ceux qui maîtrisent mieux la commande plot que
draw, il existe un second ensemble de fonctions :
with_slider andwxanimate.Normalement, les animations sont lues ou exportées avec le taux de
rafraîchissement défini dans la configuration de wxMaxima. Pour
régler la vitesse de lecture d’une animation donnée, on peut utiliser la
variable wxanimate_framerate :
wxanimate(a, 10,
sin(a*x), [x,-5,5]), wxanimate_framerate=6$Les fonctions d’animation utilisent la commande makelist
de Maxima et partagent donc le même écueil : la valeur de la
variable du curseur n’est substituée dans l’expression que si cette
variable y apparaît explicitement. Par conséquent, l’exemple suivant
échouera :
``maxima 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 est explicitement invité à substituer la valeur du curseur, le tracé fonctionne correctement :
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
)
)$Cette fonctionnalité de Maxima (sur les configurations qui la supportent), bien qu’elle ne soit pas disponible via wxMaxima, s’avère parfois bien pratique. L’exemple suivant provient d’un message de Mario Rodriguez sur la liste de diffusion de Maxima :
```maxima load(draw);
/* Une parabole dans une fenêtre #1 */ draw2d(terminal=[wxt,1],explicit(x^2,x,-1,1));
/* Une parabole dans une fenêtre #2 */ draw2d(terminal=[wxt,2],explicit(x^2,x,-1,1));
/* Un paraboloide dans une fenêtre #3 */ draw3d(terminal=[wxt,3],explicit(x2+y2,x,-1,1,y,-1,1)); ```
Il est également possible de tracer plusieurs graphiques dans une
même fenêtre (la même chose est réalisable avec la commande standard
draw() de Maxima en ligne de commande) :
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))
);Le panneau latéral “Graphiques avec draw” cache un générateur simple de code qui permet de créer des représentations graphiques exploitant une partie des fonctionnalités du package draw intégré à Maxima.
Génère le squelette d’une commande draw() pour dessiner
une scène 2D. Cette scène doit ensuite être complétée avec des commandes
qui génèrent son contenu, par exemple en utilisant les boutons situés
dans les lignes en dessous du bouton “2D”.
Une fonctionnalité utile du bouton 2D est qu’il permet de configurer la scène comme une animation dans laquelle un paramètre (par défaut, t) prend une valeur différente à chaque image : une courbe 2D animée facilite souvent l’interprétation des données plus qu’une représentation 3D statique des mêmes informations.
Génère le squelette d’une commande draw() pour tracer
une scène 3D. Si aucune scène 2D ou 3D n’est définie, tous les autres
boutons configurent automatiquement une scène 2D contenant la commande
générée par le bouton.
Ajoute un tracé standard d’une expression comme sin(x),
x*sin(x) ou x^2+2*x-4 à la commande
draw() où se trouve actuellement le curseur. Si aucune
commande draw() n’existe, une scène 2D avec ce tracé est
générée. Chaque scène peut contenir un nombre illimité de
graphiques.
Tente de trouver tous les points où une expression comme
y=sin(x), y*sin(x)=3 ou x^2+y^2=4
est vérifiée et trace la courbe résultante dans la commande
draw() où se trouve le curseur. Si aucune commande
draw() n’existe, une scène 2D avec ce tracé est
générée.
Fait varier une variable entre une borne inférieure et une borne
supérieure, puis utilise deux expressions comme t*sin(t) et
t*cos(t) pour générer les coordonnées x, y (et z dans le
cas des tracés 3D) d’une courbe, qui est ensuite insérée dans la
commande draw() actuelle.
Trace plusieurs points, éventuellement reliés entre eux. Les coordonnées des points peuvent provenir d’une liste de listes, d’un tableau 2D, ou d’une liste ou d’un tableau pour chaque axe.
Ajoute un titre en haut du graphique,
Configurer l’axe.
(Uniquement pour les tracés 3D) : Ajoute des lignes de niveau
similaires à celles que l’on trouve sur une carte de montagne aux
commandes du tracé qui suivent dans la commande draw()
actuelle et/ou au plan de base du graphique. Alternativement, cet
assistant permet de sauter entièrement le tracé des courbes et
d’afficher uniquement le tracé des lignes de niveau.
Ajoute une nouvelle entrée pour la légende affichant le nom du prochain tracé à la légende actuelle du graphique. Un nom vide désactive la génération d’entrées des légende pour les tracés suivants.
Définit la couleur de ligne pour les tracés suivants contenus dans la
commande draw() actuelle.
Définit la couleur de remplissage pour les tracés suivants contenus
dans la commande draw() actuelle.
Ouvre un assistant permettant de configurer les lignes du quadrillage.
Permet de choisir un compromis adapté entre vitesse et précision, inhérent à tout programme de tracé graphique.
Surtout lorsque vous utilisez un affichage haute résolution, la
taille de police par défaut peut être très petite. Pour les commandes
basées sur draw, vous pouvez définir la police et la taille
de police à l’aide d’options comme font=...,
font_size=..., par exemple :
wxdraw2d(
font="Helvetica",
font_size=30,
explicit(sin(x),x,1,10));Pour les commandes de type plot (par exemple
wxplot2d, wxplot3d), les tailles et polices de
caractères peuvent être définies à l’aide de la commande
gnuplot_preamble, par exemple :
wxplot2d(sin(x),[x,1,10],
[gnuplot_preamble, "set tics font \"Arial, 30\"; set xlabel font \",20\"; set ylabel font \",20\";"]);Cela définit la police pour les nombres en Arial avec une taille de 30, et la taille de la police des étiquettes xlabel et ylabel à 20 (avec la police par défaut).
Consultez la documentation de Maxima et Gnuplot pour plus d’informations. Remarque : Gnuplot semble rencontrer des problèmes avec les polices de grande taille, voir wxMaxima issue 1966.
Si le format de fichier .wxmx est utilisé, l’intégration
de fichiers dans un notebook wxMaxima peut se faire simplement
par glisser-déposer. Mais parfois (par exemple si le contenu d’une image
est susceptible de changer plus tard dans une session), il est
préférable d’indiquer au fichier de charger l’image lors de l’évaluation
:
maxima show_image("man.png");
La boîte de dialogue de configuration de wxMaxima permet de modifier deux fichiers contenant des commandes exécutées au démarrage :
maxima-init.macwxmaxima-init.macPar exemple, si Gnuplot est installé dans /opt
(peut-être sur macOS), vous pouvez ajouter
gnuplot_command:"/opt/local/bin/gnuplot"$ (ou
/opt/gnuplot/bin/gnuplot ou tout autre chemin) à ces
fichiers.
Ces fichiers se trouvent dans le répertoire utilisateur de Maxima
(généralement %USERPROFILE%/maxima sous Windows, ou
$HOME/.maxima sinon). Vous pouvez connaître leur
emplacement avec la commande : maxima_userdir;
wxsubscripts tells Maxima if it should convert
variable names that contain an underscore (R_150 or the
like) into subscripted variables. See wxdeclare_subscript
for details which variable names are automatically converted.wxfilename: This variable contains the name of the file
currently opened in 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 defines the resolution of embedded
plots.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: The number of frames per second
the following animations have to be played back with.wxanimate_autoplay: Automatically play animations by
default?wxmaximaversion: Returns the version number of
wxMaxima.wxwidgetsversion: Returns the wxWidgets version
wxMaxima is using.La fonction table_form() affiche une liste 2D sous une
forme plus lisible que le résultat produit par la sortie par défaut de
Maxima. L’argument doit être une liste contenant une ou
plusieurs listes. Comme la commande “print”, cette commande affiche le
résultat même si elle se termine par un dollar ($). Si elle
se termine par un point-virgule (;), le tableau s’affiche
accompagné d’un message “done”.
table_form(
[
[1,2],
[3,4]
]
)$Comme le montre l’exemple suivant, les listes utilisées par la
commande table_form peuvent être créées avant son
exécution.
De même, comme une matrice est une liste de listes, elle peut être convertie en tableau de manière similaire.
WxMaxima propose quelques fonctions qui collectent des informations utiles pour signaler un bug concernant le système actuel :
wxbuild_info() gathers information about the currently
running version of wxMaximawxbug_report() tells how and where to file bugsLa commande box() de Maxima permet à
wxMaxima d’afficher son argument en rouge, si le deuxième
argument de la commande est le texte highlight.
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.
Le menu d’aide de wxMaxima donne accès au manuel de Maxima
et à celui de wxMaxima, à des astuces, à des exemples de notebooks,
ainsi qu’aux exemples intégrés dans Maxima en ligne de commande (via la
commande demo()).
Veuillez noter que les exemples indiquent :
~ À l’invite ’_’, tapez ; puis
<entrée> pour poursuivre la démonstration.
~
Cela est valable pour Maxima en ligne de commande, mais dans wxMaxima, par défaut, il est nécessaire de poursuivre la démonstration avec : CTRL + ENTRÉE
(Ce comportement peut être configuré dans le menu Configurer → Notebook → “ Raccourcis pour envoyer des commandes à Maxima”.)
Puisque Maxima (le programme qui effectue les calculs mathématiques) et wxMaxima (qui fournit l’interface utilisateur conviviale) sont deux programmes distincts qui communiquent via une connexion réseau locale, la cause la plus probable d’un dysfonctionnement est que cette connexion ne s’établit pas correctement. Par exemple, un pare-feu peut être configuré non seulement pour bloquer les connexions non autorisées depuis Internet (et éventuellement intercepter certaines connexions sortantes), mais aussi pour empêcher la communication entre processus sur un même ordinateur. Notez que, comme Maxima est exécuté via un processeur Lisp, le processus bloqué ne porte pas nécessairement le nom “maxima”. Les noms usuels pour le programme ouvrant la connexion réseau peuvent être sbcl, gcl, ccl, lisp.exe, ou des noms similaires.
Sur les ordinateurs Unix, une autre cause possible serait que le réseau loopback, qui permet les connexions entre deux programmes sur le même ordinateur, ne soit pas correctement configuré.
En informatique, la plupart des formats modernes basés sur XML sont
en réalité des fichiers zip ordinaires. WxMaxima n’active pas
la compression, donc le contenu des fichiers .wxmx peut
être consulté avec n’importe quel éditeur de texte.
Si la signature du zip à la fin du fichier est toujours intacte après
avoir renommé un fichier .wxmx corrompu en
.zip, la plupart des systèmes d’exploitation permettront
d’extraire une partie des informations qu’il contient. Cette méthode est
souvent utilisée pour récupérer les fichiers image originaux d’un
document issu d’un traitement de texte. Si la signature du zip n’est
plus intacte, ce n’est pas forcément une impasse : si wxMaxima
a détecté une erreur lors de l’enregistrement, un fichier
.wxmx~ aura probablement été créé et son contenu pourrait
s’avérer utile.
Et même s’il n’existe pas un tel fichier : le format
.wxmx est un format conteneur et la partie XML y est
stockée sans compression. Il est possible de renommer le fichier
.wxmx en .txt et d’utiliser un éditeur de
texte pour récupérer la portion XML du contenu (elle commence par
<?xml version="1.0" encoding="UTF-8"?> et se termine
par </wxMaximaDocument>. Avant et après ce texte,
vous verrez du contenu binaire illisible dans l’éditeur).
Si vous enregistrez un fichier texte contenant uniquement ce contenu
(par exemple, en copiant et collant ce texte dans un nouveau fichier)
avec une extension .xml, wxMaxima saura comment
récupérer le texte du document.
commande ne soit terminée
Normalement, wxMaxima attend que la formule 2D soit
transférée en totalité avant de commencer la composition typographique.
Cela permet d’économiser du temps en évitant de tenter d’écrire une
équation incomplète. Cependant, il existe une commande disp
qui affiche immédiatement des informations de débogage, sans attendre la
fin de l’exécution de la commande Maxima en cours :
``maxima 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) )$
Sinon, on peut utiliser la commande `wxstatusbar()` mentionnée ci-dessus.
## La création d'un graphique n'affiche qu'une enveloppe vide encadrée avec
un message d'erreur
Cela signifie que _wxMaxima_ n'a pas pu lire le fichier généré par _Maxima_,
qui était censé donner les instructions à _Gnuplot_ pour créer le graphique.
Les causes possibles de cette erreur sont :
- 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.
## Le tracé d'une animation génère l'erreur "error: undefined variable"
Par défaut, la valeur du paramètre pour le curseur n'est substituée dans
l'expression à tracer que si elle y est visible. L'utilisation d'une
commande `subst` qui substitue la variable du curseur dans l'équation à
tracer résout ce problème. À la fin de la section [Intégrer des animations
dans le notebook](#embedding-animations-into-the-spreadsheet), vous pouvez
voir un exemple.
## J’ai perdu le contenu d’une cellule et la fonction Annuler ne le restaure
pas
Il existe des fonctions Annuler distinctes pour les opérations sur les
cellules et pour les modifications à l’intérieur des cellules, donc il est
peu probable que cela arrive. Si cela se produit, plusieurs méthodes
permettent de récupérer les données :
- _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.
- If nothing else helps _Maxima_ contains a replay feature:
```maxima playback(); ```
## _WxMaxima_ démarre avec le message Maxima process terminated
Une cause possible est que le programme _Maxima_ n’est pas trouvé à
l’emplacement indiqué dans l’onglet Maxima de la boîte de dialogue de
configuration de _wxMaxima_, ce qui l’empêche de démarrer. Vérifiez et
corrigez le chemin vers l’exécutable _Maxima_ pour résoudre ce problème.
## Maxima calcule indéfiniment et ne répond plus aux commandes entrées
Il est théoriquement possible que _wxMaxima_ ne détecte pas que _Maxima_ a
terminé ses calculs et, de ce fait, n’autorise pas l’envoi de nouvelles
données. Dans ce cas, l’option Déclencher l’évaluation (« Trigger
evaluation ») peut resynchroniser les deux programmes.
## Mon _Maxima_ basé sur SBCL manque de mémoire
Le compilateur Lisp SBCL est configuré par défaut avec une limite de mémoire
qui lui permet de fonctionner même sur des ordinateurs peu
puissants. Cependant, lors de la compilation de gros packages logiciels
comme Lapack ou du traitement de listes d'équations extrêmement longues,
cette limite peut s'avérer insuffisante. Pour l'augmenter, vous pouvez
utiliser le paramètre en ligne de commande `--dynamic-space-size` lors du
lancement de SBCL, qui indique combien de mégaoctets doivent être
réservés. - Une version 32 bits de SBCL sous Windows peut réserver jusqu'à
999 Mo. - Une version 64 bits sous Windows peut aller au-delà des 1280 Mo
nécessaires pour compiler Lapack.
Une façon de fournir des paramètres en ligne de commande à _Maxima_ (et donc
à SBCL) est d’utiliser le champ "Paramètres supplémentaires pour Maxima"
dans la boîte de dialogue de configuration de _wxMaxima_.
{ id=img_sbclMemory }
## Sous Ubuntu, la saisie est parfois lente ou certaines touches sont
ignorées
L'installation du paquet 'ibus-gtk' devrait résoudre ce problème. Pour plus
de détails, voir :
[https://bugs.launchpad.net/ubuntu/+source/wxwidgets3.0/+bug/1421558](https://bugs.launchpad.net/ubuntu/+source/wxwidgets3.0/+bug/1421558).
## _WxMaxima_ se fige lorsque _Maxima_ traite des caractères grecs ou des
lettres accentuées (comme les umlauts)
Si votre _Maxima_ est basé sur SBCL, ajoutez les lignes suivantes à votre
fichier `.sbclrc` :
```commonlisp (setf sb-impl::*default-external-format* :utf-8) ```
Le dossier où ce fichier doit être placé dépend du système et de
l’installation. Cependant, toute version de _Maxima_ basée sur SBCL, ayant
déjà évalué une cellule durant la session en cours, peut gentiment indiquer
son emplacement après exécution de la commande suivante :
``` :lisp (sb-impl::userinit-pathname) ```
## Remarque concernant Wayland (distributions Linux/BSD récentes)
Il semble y avoir des problèmes de compatibilité entre le serveur
d'affichage Wayland et wxWidgets. WxMaxima peut en être affecté, par exemple
avec des barres latérales qui ne peuvent pas être déplacées.
Vous pouvez soit : - désactiver Wayland et utiliser X11 à la place (de
manière globale), - ou forcer WxMaxima à utiliser le système X Window en
définissant la variable d’environnement : `GDK_BACKEND=x11`
Par exemple, lancez WxMaxima avec la commande :
`GDK_BACKEND=x11 wxmaxima`
## Pourquoi le navigateur pour le manuel intégré n’est-il pas disponible sur
mon PC Windows ?
Either wxWidgets wasn’t compiled with support for Microsoft’s webview2 or
Microsoft’s webview2 isn’t installed.
## Pourquoi le navigateur pour le manuel externe ne fonctionne-t-il pas sur
ma machine Linux ?
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.
## Puis-je faire en sorte que _wxMaxima_ génère à la fois des fichiers image
et des graphiques en ligne en même temps ?
Le notebook intègre les fichiers `.png`. _WxMaxima_ permet à l'utilisateur
de spécifier où ces fichiers doivent être générés :
```maxima
wxdraw2d(
file_name="test", /* extension .png automatically added */
explicit(sin(x),x,1,10)
);Si vous souhaitez utiliser un format différent, il est plus simple de générer les images séparément, puis de les réimporter dans le notebook :
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)
);en ligne ?
Utilisez la variable wxplot_size :
wxdraw2d(
explicit(sin(x),x,1,10)
),wxplot_size=[1000,1000];affichent des messages d’erreur du type
1 HIToolbox 0x00007ff80cd91726 _ZN15MenuBarInstance22EnsureAutoShowObserverEv + 102 2 HIToolbox 0x00007ff80cd912b8 _ZN15MenuBarInstance14EnableAutoShowEv + 52 3 HIToolbox 0x00007ff80cd35908 SetMenuBarObscured + 408 ...
Ce problème pourrait être lié au système d’exploitation. Désactiver le masquage automatique de la barre de menus (via Réglages Système => Bureau et Dock => Barre des menus) pourrait résoudre le problème. Pour plus d’informations, voir l’issue wxMaxima #1746.
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.
Oui. Utilisez le package LaTeX “geometry” pour définir la taille des marges.
Vous pouvez ajouter la ligne suivante dans le préambule LaTeX (par exemple via le champ dédié dans la fenêtre de configuration : (“Export” → “Lignes supplémentaires pour le préambule TeX”) pour régler les marges à 1 cm :
latex \usepackage[left=1cm,right=1cm,top=1cm,bottom=1cm]{geometry}
Si wxWidgets est suffisamment récent, wxMaxima passera automatiquement en mode sombre si le système d’exploitation l’est également. Par défaut, la feuille de travail a un fond clair, mais cela peut être personnalisé. Sinon, il existe une option ‘Affichage/Inverser la luminosité de la feuille’ qui permet de basculer rapidement entre un fond clair et un fond sombre.
minute d’utilisation
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.
’xx_YY’ can not be set” occurs
(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.
Ces langues locales peuvent ne pas être présentes dans le système.
Sur les systèmes Ubuntu/Debian, elles peuvent être générées avec :
dpkg-reconfigure locales
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.
ou en ligne de commande ?
Si wxMaxima est utilisé, la variable Maxima
maxima_frontend est définie sur wxmaxima. Dans
ce cas, la variable Maxima maxima_frontend_version contient
la version de wxMaxima.
Si aucun programme pour le frontend n’est utilisé (si vous utilisez
Maxima en ligne de commande), ces variables valent
false.
Généralement, les programmes dotés d’une interface graphique se lancent simplement en cliquant sur une icône ou une entrée de menu. WxMaxima, lorsqu’il est démarré depuis la ligne de commande, accepte néanmoins certains arguments.
-v ou --version : affiche les informations
de version-h ou --help : affiche un texte d’aide
succinct-o ou --open=<fichier> : ouvre le
fichier spécifié en argument de cette option de la ligne de
commande-e ou --eval : évalue le fichier après
l’avoir ouvert.-b ou --batch : si un fichier est ouvert
en ligne de commande, toutes ses cellules sont évaluées et le fichier
est ensuite enregistré. Cela peut être utile, par exemple, si la session
décrite dans le fichier amène Maxima à générer des fichiers de
sortie. Le traitement en mode batch s’arrête si wxMaxima
détecte une erreur émise par Maxima, et s’interrompt au cas où
Maxima pose une question : la nature interactive des
mathématiques ne permet pas toujours un traitement entièrement
automatisé.--logtostderr : redirige aussi les messages de débogage
(barre latérale) vers stderr.--pipe : transmet les messages de Maxima vers
stdout.--exit-on-error : ferme le programme en cas d’erreur
Maxima.-f ou --ini=<fichier> : utilise le
fichier d’initialisation spécifié en argument.-u, --use-version=<version> :
utilise la version <version> de Maxima.-l, --lisp=<compilateur> : utilise
une version de Maxima compilée avec le compilateur Lisp
<compilateur>.-X, --extra-args=<args> : permet de
passer des arguments supplémentaires à Maxima.-m ou --maxima=<chemin> : spécifie
l’emplacement du binaire maxima.--enableipc : permet à Maxima de contrôler wxMaxima via
une communication inter-processus (à utiliser avec prudence).--wxmathml-lisp=<fichier> : indique l’emplacement
de wxMathML.lisp (pour remplacer la version intégrée,
principalement pour les développeur·ses).Certains systèmes d’exploitation peuvent utiliser un tiret long (—) au lieu d’un tiret court (-) devant les options en ligne de commande.
wxMaxima est principalement développé en C++ avec le framework wxWidgets, et utilise CMake comme système de build. Une petite partie est écrite en Lisp. Si vous maîtrisez ces langages et souhaitez contribuer à ce projet open source, vous pouvez rejoindre l’équipe sur GitHub.
Mais les programmeurs ne sont pas les seul·es à pouvoir contribuer ! Vous pouvez aussi aider à améliorer wxMaxima en améliorant la documentation, en signalant (ou corrigeant) des bugs, en proposant de nouvelles fonctionnalités, en traduisant l’interface ou le manuel dans votre langue (consultez le fichier README.md dans le dossier locales pour savoir comment procéder).
Ou répondre aux questions d’autres utilisateurs sur le forum de discussion.
Le code source de wxMaxima est documenté avec Doxygen, disponible ici.
Le programme est quasi complet : hormis les bibliothèques système (et
la bibliothèque wxWidgets), il ne nécessite aucune dépendance externe
(comme des fichiers graphiques ou le logiciel Lisp. Les éléments comme
le fichier ( wxmathML.lisp) sont intégrés directement dans
l’exécutable.
Si vous êtes développeur et que vous souhaitez tester une version
modifiée du fichier wxmathML.lisp sans tout recompiler,
vous pouvez utiliser l’option en ligne de commande :
--wxmathml-lisp=<chemin> pour spécifier un autre
fichier Lisp à la place de celui intégré à la version actuelle.