MathPlot ======== © par Rüdiger Dreier 1991/92/93/94 Ce manuel est un résumé du manuel que vous obtiendrez en devenant utilisateur officiel de MathPlot (cf. "Registrierung.txt" pour plus d'informations). Mon adresse est Rüdiger Dreier Gustav-Winkler-Str. 40 33699 Bielefeld Germany Vous pouvez me contacter via EMail: ruediger.dreier@post.uni-bielefeld.de Quelques mots de droit ====================== L'AUTEUR DECLINE TOUTE RESPONSABILITE DES LES DOMMAGES CAUSES PAR L'UTILISATION CORRECTE OU INCORRECTE DE CE PROGRAMME! L'AUTEUR NE S'ENGAGE PAS A CE QUE CE PROGRAMME NE COMPORTE AUCUNE ERREUR ! UTILISEZ-LE A VOS RISQUES ET PERILS MathPlot est un ShareWare ! Si vous utilisez ce programme, vous devez payer la charge de ShareWare (cf. "Registrierung.TXT"). Cette version de MathPlot ========================= Cette version est une version de démonstration avec un requester vous informant que MathPlot est un ShareWare. Elle peut être copiée sous les conditions suivantes: - Le texte de copyright ne doit être ni supprimé, ni modifié. - Vous n'êtes pas autorisés à gagner de l'argent en copiant ce programme (sauf une petite somme pour les disquettes, le port, etc). - Ce programme NE DOIT PAS être modifié. - Le programme doit être complet: les fichiers suivants doivent être inclus: * La documentation complète et inchangée (un langue suffit). * Une copie de MathPlot * Une version de mtool.library - La permission écrite de l'auteur est necessaire pour utiliser MathPlot (tout ou partie) ou la mtool.library (tout ou partie) dans un but commercial. - Il EST PERMIS de traduire le texte du menu (fichier TextDaten) dans une autre langue et de l'inclure dans une copie de ce programme. Si vous le faites, veuillez m'envoyer une version de ce nouveau fichier de textes et indiquez si vous m'autorisez à l'inclure dans les versions ShareWare et commerciales de MathPlot. - Il est permis de placer cette version de MathPlot dans toutes les mailbox et de l'inclure dans une série de disquettes DP (comme celle de Fred Fish), tant que le prix n'est pas trop élevé (c'est-à-dire moins de DM5 -ou (US)$5- par disquette, et moins de DM60 -ou (US)$30 par CD). Le ShareWare ============ MathPlot est un ShareWare. Si vous utilisez ce programme, vous voudrez peut-être payer les droits d'enregistrement. Ils sont de (US)$20 -ou DM30-. Envoyez cet argent à l'adresse indiquée plus haut et ajoutez le nom et la version du programme (et peut-être où vous l'avez trouvé). Vous trouverez un formulaire à remplir dans le fichier "Registrierung.txt". 'Pourquoi payer?', me direz-vous. Parce que vous recevrez: - La version (complete) la plus récente de MathPlot. Cette version NE DOIT PAS être donnée aux autres. - Un manuel imprimé (la version complete de celui-ci). Indiquez-moi si vous désirez recevoir la version allemande ou anglaise. - Un service de mise à jour: vous pourrez recevoir de nouvelles versions de MathPlot en m'envoyant une disquette, une enveloppe affranchie et votre numéro d'utilisateur. S'il n'y a pas de nouvelle version, j'attendrais qu'il y en ai une; cela peut donc prendre un certain temps. Indiquez-moi quelle version vous avez. Si vous pouvez être joints via EMail, je vous enverrais la mise à jour sous la forme d'un fichier texte UUENCODE. Le fichier source ================= Le texte source NE PEUT PAS être distribué librement. Il peut être com- mandé par les utilisateurs officiels à l'adresse indiquée plus haut pour la somme de (US)$20 -ou DM30-. Si vous voulez utiliser le fichier source dans un but commercial, il vous faudra la permission écrite de l'auteur (MOI!). Ce que fait ce programme ======================== Mathplot est un petit programme pour tracer les fonctions bidimension- nelles. Vous pouvez entrer et tracer jusqu'à dix fonctions simultanément, plus leurs dérivées premières et secondes. Il est également possible de faire une discussion sur la fonction, et de calculer une intégrale. Un port ARexx est inclus. Le programme peut donc être utilisé par exemple pour contrôler vos propres résultats. Ce dont vous avez besoin ======================== !! Le programme ne fonctionne que sur les Amigas dotés de Kickstart (ROM) version 2.04 ou plus. 1Mo de mémoire devrait suffire; 1Mo de mémoire chip et les nouveaux circuits personnalisés donnent de bons résultats pour de grands écrans (mode productivity, etc.). La pile (stack) devrait être d'au moins 20000 octets. Dans LIBS:, vous devez avoir: - mathieeedoubbas.library - mathieeedoubtrans.library - asl.library - mtool.library (qui devrait aussi être sur cette disquette) - diskfont.library (V36 ou plus) - iffparse.library (pour sauvegarder les courbes en fichiers IFF) Dans S: vous pouvez avoir (en option): - mplot.prefs, un fichier de préférences. - Funktionen.fkt, quelques exemples de fonctions - Konstanten.con, quelques constantes - Macros.mcr, quelques macros. Si vous voulez utiliser le port ARexx, vous devrez copier tous les fichiers de Macros/ vers rexx: (un "assign .... add" semble ne pas marcher). Les menus ========= Projet ------ Nouveau ------- Après confirmation, efface l'écran et stoppe la table traçante le cas échéant. L'écran est automatiquement effacé après un changement d'intervalle. Sauver IFF ----------- Pour utiliser cette option, iffparse.library doit être dans libs:. Si le programme ne peut pas le trouver, un requester apparaitra (iffparse.library ?). Sinon, il vous demandera le nom du fichier. En cas d'erreur, un autre requester apparait. L'icône du programme est utilisée pour ce fichier (si lancé du Workbench). Charger/Sauver fonctions/macros/constantes ------------------------------------------ Le programme vous demande le nom du ficher à sauver/charger. Imprimer -------- Imprime l'écran avec le driver des préférences (aussi grand que possible). Durant l'impression, les couleurs de l'écran sont changées et la table traçante est stoppée. Iconifier --------- Ferme la fenêtre et crée une icône sur l'écran du workbench. Double-clicker cette icône relance le programme. Les dernières fonctions sont toujours accessibles. S'il n'y a pas assez de mémoire pour rouvrir l'écran, le programme prend fin. L'icône utilisée est celle du programme (si lancé du Workbench). Informations ------------ Quelques informations sur ce programme (la version, mon adresse, le nom de l'écran, etc.) Quitter MathPlot ---------------- Le programme prend fin si vous confirmez. Comme l'écran est un écran publique, il peut y avoir des fenêtres de programmes "visiteur". Si c'est le cas, vous ne pourrez pas quitter MathPlot. Tracer ------ Modifier fonction ----------------- Vous pouvez choisir la fonction dans le sous-menu, et la modifier dans la fenêtre qui apparait ensuite. La fonction doit être une expression correcte. Si vous entrez quelque-chose comme sin((x), la fenêtre réapparait tant qu'il y a une parenthèse de trop. Tracer/Derivée/Derivée seconde numérique/symbolique -------------------------------------------- Choisissez la fonction pour la tracer (ou sa derivée ou sa derivée seconde). Les derivées symboliques sont d'abords calculées puis tracées (par exemple pour sin(x), cos(x) est d'abord trouvé comme derivée de sin(x), puis cos(x) est tracé). Les derivées symboliques sont les plus précises, mais il peut y avoir des problèmes avec certaines fonctions (abs, sgn, ln). Par exemple 1/x sera considerée comme la derivée de ln même pour x négatif. Les derivées symboliques sont calculées recursivement, donc la pile (stack) doit être d'au moins 20000 octets. Si vous avez un guru, essayez une pile plus grande. Discussion ---------- Donne quelques informations sur la fonction selectionnée: intervalle d'etude, derivée, derivée seconde, points d'intersection avec l'axe des abscisses, extremums et points d'inflexion. Les derivées ------------ 1. +-*/ comme d'habitude 2. x^a a*x^(a-1) 3. a^x a^x*\ln{a} 4. f(x)^{g(x)} (g(x)*\ln(f(x)))'*f(x)^{g(x)} 5. trig. fonctions comme d'habitude 6. abs(x) sgn(x) (bien qu'incorrect pour x=0) 7. int(x) 0 (bien qu'incorrect pour x entier relatif) 8. sgn(x) 0 (bien qu'incorrect pour x=0) IMPORTANT --------- !! L'AUTEUR NE S'ENGAGE PAS A L'EXACTITUDE DES DERIVEES CALCULEES !! !! AVANT D'UTILISER CES RESULTATS, RECALCULEZ-LES A LA MAIN!!!! Integration numérique --------------------- Integre une fonction numériquement. La fenêtre qui apparait vous permet de modifier la fonction, et de préciser l'intervalle d'intégration. Plus vous utilisez de pas, plus les calculs sont longs et plus les résultats sont précis. Annuler ferme la fenêtre. Codes d'erreur du programme --------------------------- DIVBYZERO & 1 & division par zero LOGNEG & 2 & log(<= 0) SQRTNEG & 4 & sqrt{ < 0} ATRIG & 8 & asin, acos avec arg >1 or <1 UNPAKLAM & 16 & trop de parenthèses TEST & 32 & -pas utilisé- NOFUNC & 64 & aucune fonction donnée NO_KONST & 128 & Constante inconnue NO_MEM & 256 & mémoire saturée POWERROR & 512 & vous avez essayé (<0) ^ (a/b) NO_FUNC & 1024 & fonction introuvable ER_AHYP & 2048 & erreur dans acosh() ou atanh() Edition ------- Tracer les axes --------------- Ajoute les axes sur le graph. S'il y a un graph, vous ne pourrez ajouter les axes qu'une seule fois; donc testez vos axes en premier. Zoom ---- Permet de definir (grâce à un élastique) la partie de l'intervalle qui sera ensuite tracée. Inserer du texte ---------------- Permet de placer un commentaire sur le graph, avec les police, couleurs et mode d'impression choisis. Precision --------- Definit la précision des calculs. Plus elle est haute, plus le graph est précis, mais plus les temps de calculs sont longs. Changer l'intervalle -------------------- La fenêtre qui s'ouvre vous permet de spécifier l'intervalle d'étude des fonctions et le type d'affichage désiré. Par exemple: vous voulez tracer un graph sur [-pi;pi]. Vous pouvez entrer -pi et pi et choisir un repérage cartesien (*1). Mais vous pouvez aussi entrer -1, 1 et *pi dans le gadget tournant. Essayez les deux et tracez les axes, vous verrez la difference. Pour avoir un affichage logarithmique sur X et Y, choisissez 10^ dans les deux gadgets tournants et ainsi de suite. Constantes ---------- Choisissez une lettre avec le clavier ou avec le gadget tournant, puis pressez RETURN. Vous pourrez alors entrer la definition de la constante. Dans les autres fonctions, vous pouvez utiliser ces constantes par leurs noms: par exemple definissez une constante z en entrant pi. Vous pouvez alors utiliser z au lieu de pi dans toutes les fonctions. N'utilisez ni x ni e comme noms de constantes parce qu'elles ne peuvent pas être utilisées plus tard (e est defini comme 2.71...). Macros ------ Les macros se definissent de la même manière que les constantes, et s'utilisent via _NOMDELAMACRO ou _NOMDELAMACRO(paramètre): par exemple _a ou _a(2*x). Si vous utilisez la deuxième methode, chaque x dans la macro est remplacé par le paramètre. Table traçante -------------- L'option ON vous demande un nom de fichier où enregistrer les données. OFF supprime la sortie sur table traçante (ce qui est fait automatiquement lors d'un changement d'intervalle ou lors d'une impression). Après avoir selectionné OFF, le fichier contient les données compatibles HP-Plotter nécessaires au traçage des fonctions et textes affichés depuis la selection de ON. Je n'ai pas de traceur HP-Plotter, j'ai utilisé le device PLT: et ça marche. Choisir/Changer couleurs ------------------------ Permet de changer les palette de MathPlot (il y en a une normale, une pour l'impression et une pour la sortie sur table traçante). La dernière couleur selectionnée dans le requester est également utilisée pour les tracés suivants. Changer police et couleur ------------------------- Permet de choisir une nouvelle police pour Inserer du texte, pour les graduations des axes et pour l'écran. le font-requester standard est utilisé. Changer la résolution --------------------- Permet de choisir la résolution et le mode d'affichage de l'écran. Changer types de lignes ----------------------- Permet de definir les pointillé et les types de lignes. Discussion ---------- Utilisez cette option pour definir quelques paramètres de la discussion. ARexx ----- Commencer une macro ARexx ------------------------- Choisissez un des fichiers proposés (extension .mapl dans rexx:). Vous pouvez commencer une macro avec un double click. Ne commencez PAS les fichiers finissant par .mpl; ces fichiers peuvent necessiter d'autres arguments. Definir macros ARexx -------------------- Il peut y avoir dix macros que vous pouvez lancez d'un simple double click. Cette option vous permet de choisir ces macros Enregistrer ----------- Le programme peut enregistrer quelques actions (modifier fonction, constantes et macros, changer intervalle, changer couleurs et tracer les axes). Entrez le nom du fichier où sauver les actions. Vous pouvez aussi choisir si le programme sauve son statut dans ce fichier. Préferences ----------- Le programme ne réagit pas de la même manière aux options actives et aux préferences. Les options actives definissent le comportement effectif du programme (par exemple la couleur utilisée pour tracer la prochaine fonction) alors que les préferences definissent le comportement du programme au démarrage (par exemple la couleur par défaut des courbes). Les préferences deviennent des options actives si l'on choisis "Utiliser" ou si l'on relance le programme. La plupart des options de ce menu sont aussi présentes dans d'autres menus, aussi leur description est ici très brève. Charger ------- Charge un nouveau fichier de préferences, dont les options deviennent actives. Utiliser -------- Les préférences deviennent des options actives. L'écran se ferme et un nouvel écran s'ouvre avec la plupart des nouvelles options. Seules quelques options ne peuvent être activées en selectionnant "Utiliser", voir plus bas. Pour ces options, vous devrez relancer le programme. Sauvegarder ----------- Sauvegarde les options. Changer l'intervalle -------------------- Permet de choisir le nouvel intervalle. Choisir/changer couleurs ------------------------ Change la palette initiale et la couleur du tracé. Choisir police et couleur ------------------------- Change la police, la couleur et le mode de tracé initiale. Changer types de lignes ----------------------- Permet de choisir le type de lignes des courbes. Précision --------- Definit la précision initiale. Si vous avez commencé sans fichier .prefs, vous DEVEZ choisir un mode. Changer chemins d'accès ----------------------- Cette option n'est présente que dans ce menu. Au démarrage, le programme charge un fichier avec tous les textes, un fichier avec les fonctions par défaut, un avec les constantes par défaut, et un avec les macros par défaut. Ces fichiers peuvent être choisis ici. Vous devrez relancer le programme (l'option "Utiliser" ne suffit pas) pour valider ces paramètres. De plus, vous pouvez definir le chemin d'accès par défaut des requesters de fichier IFF et de fichier rexx, et d'autres requesters. Raccourcis clavier ------------------ Cette option n'est présente que dans ce menu. Vous pouvez changer les touches équivalentes aux différentes options. Vous pouvez d'abord changer une chaîne dont - le premier caractère est la majuscule équivalente à [OK], - le second caractère est la majuscule équivalente à [CANCEL], - les quatre caractères suivants permettent de modifier les chaîne dans les requesters, - les quatre caractères suivants permettent d'actionner un gadget tournant, - les six derniers caractères permettent de choisir les couleurs et d'en modifier les composantes RVB. Ensuite, il vous est proposé d'assigner un raccourci à chaque option du menu. Discussion ---------- Permet de choisir les paramètres par défaut de la discussion. Options et syntaxe ================== Syntaxe des fonctions --------------------- Les fonctions peuvent être composées de ()+-*/^, sin, cos, tan, log, int, sgn, abs, sqr, asin, acos, atan, sinh, cosh, tanh, asinh, acosh, atanh, ln, les constantes a-z (sauf x et e), et la variable x. e (2.71...) et pi sont prédefinies. Les nombres doivent être dans un format usuel (1; 1.1; .1; 3e5; 5e-7, etc.). Les macros sont utilisées sous la forme _NOM ou _NOM(paramètre). Utilisez des parenthèses pour être sûr que MathPlot trace la fonction desirée. Il utilise les règles de priorité classiques (^ avant *, / avant +,etc.). Options ------- MathPlot charge s:mplot.prefs au démarrage. Vous pouvez choisir un autre fichier en utilisant le tooltype SETTINGS. Le port ARexx ============= Introduction ------------ MathPlot possède maintenant un port ARexx-Port (nommé "MPlot_ARexx"). Le code est généré par ARexxBox V1.00 qui est © par Michael Balzer. Les commandes ARexx ------------------- Voici une liste de toutes les commandes. Le format des options correspond à la façon dont le système affiche les options des commandes dans le Shell. Consultez votre manuel pour savoir le sens de tous les signes qui suivent les "/". BEEP Un simple DisplayBeep() CLEAR FORCE/S Efface l'écran. Avec FORCE, il n'y a pas de requester. EVALSTRING VAR/K,STEM/K,FUNCTION/A,X/K => VALUE Evalue une chaîne. FAULT VAR/K,STEM/K,NUMBER/N/A => DESCRIPTION Pas defini. GET1DERIVE VAR/K,STEM/K,NUMBER/N/A => DERIVE Donne la derivée symbolique d'une fonction. Les fonctions sont numérotées de 0 à 9; utilisez ces chiffres pour les designer. GET2DERIVE VAR/K,STEM/K,NUMBER/N/A => DERIVE Idem pour la derivée seconde. GETCOLOR VAR/K, STEM/K, TEXTCOLOR/S, AXISCOLOR/S, PLOTCOLOR/S, TEXTCOLORBACK/S, AXISCOLORBACK/S, TEXTMODE/S, AXISMODE/S => TEXTCOLOR/N, AXISCOLOR/N, PLOTCOLOR/N, TEXTCOLORBACK/N, AXISCOLORBACK/N, TEXTMODE/N, AXISMODE/N Donne le nombre de couleurs et les modes de traçage. GETCONST VAR/K,STEM/K,NAME/A => DEFINITION Donne la definition d'une constante. Le nom doit être un caractère. GETERROR VAR/K,STEM/K => NUMBER/ Donne la dernière erreur. GETFUNCTION VAR/K,STEM/K,NUMBER/N/A => DEFINITION cf. GETCONST. GETINTERVALL VAR/K,STEM/K,XAXIS/S,XMIN/S,XMAX/S,YAXIS/S,YMIN/S,YMAX/S => DEFINITIONSTRING,DEFINITIONNUMBER/N Donne la definition d'un intervalle. N'utilisez qu'une option à la fois. GETMACRO VAR/K,STEM/K,NAME/A => DEFINITION cf GETCONST. GETPOINTS VAR/K, STEM/K, FUNCTION/A, ZERO/S, MAX/S, TURN/S => XPOINTS/M, YPOINTS/M, TYP/M Une discussion via ARexx. Une seule option à la fois! GETPRECISION VAR/K,STEM/K => PRECISION/N Donne la précision. HELP VAR/K,STEM/K,COMMAND,PROMPT/S => COMMANDDESC,COMMANDLIST/M Donne la liste de toutes les commandes ou de toutes les options pour une commande. HPGL_ON FILENAME Active la sortie HPGL. LABELPEN COLOR/N Defini le stylo pour les axes. LOADCONST FILENAME LOADFUNC FILENAME LOADMACRO FILENAME Charge les definitions. NEW PORTNAME/K Efface l'écran. PORTNAME n'est pas defini. NUMINT VAR/K,STEM/K,STEPS/N/A,XMIN/A,XMAX/A,FUNCTION/A => VALUE Integre une fonction. PLOT NUMBER/N/A,NORMAL/K/S,DERIVE1/K/S,DERIVE2/K/S,DERIVE1NUM/K/S, DERIVE2NUM/K/S,FORCE/S Trace une fonction. PRINT PROMPT/S Imprime l'écran. QUIT FORCE/S Quitte le programme. Avec FORCE, il n'y aura pas de requester. REQUESTFILE VAR/K,STEM/K,TITLE/K,PATH/K,FILE/K,PATTERN/K,SAVE/S => FILENAME Donne un requester de fichier. REQUESTNOTIFY PROMPT/K/A,BUTTON/K Ne pas utiliser pour l'instant. REQUESTNUMBER VAR/K,STEM/K,PROMPT/K,DEFAULT/K/N => NUMBER/N Demande un nombre à l'utilisateur. REQUESTRESPONSE VAR/K,STEM/K,TITLE/K,PROMPT/K/A,BUTTON/K => RETURN/N Appelle un EasyRequest avec TITLE comme titre, PROMPT comme texte et BUTTON (par exemple "OUI|NON|ANNULER") comme gadgets. RC est 5 pour le gadget le plus à droite, sinon le résultat est 1,2... REQUESTSTRING VAR/K,STEM/K,PROMPT/K,DEFAULT/K,TITLE/K => STRING Demande une chaîne à l'utilisateur. RX VAR/K,STEM/K,CONSOLE/S,ASYNC/S,COMMAND/F => RC/N,RESULT Lance un script. SAVECONST FILENAME SAVEFUNC FILENAME Sauvegarde les definitions dans un fichier. SAVEIFF FILENAME Sauvegarde l'écran en IFF. SAVEMACRO FILENAME cf. SAVEFUNC. SCREENTOBACK Place l'écran au dernier plan. SCREENTOFRONT Place l'écran au premier plan. SELECTMENU MENU/N/A,ITEM/N/A,SUB/N,FORCE/S Selectionne un menu. 0 est le premier. FORCE supprime quelques requesters. N'utilisez pas cette commande directement dans un script, parce que les numéros peuvent changer. Procedez comme suit: Supposons que vous vouliez afficher les informations sur le programme. Cela correspond à MENU=0 ITEM=13 dans cette version. Au lieu de SELECTMENU 0 13 utilisez MONTREINFO. Ecrivez un fichier "montreinfo.mpl" composé de deux lignes: "/* */" et "selectmenu 0 13". Copiez ce fichier vers REXX:. Si le numéro de l'option change (par exemple s'il passe à 14), vous n'aurez à changer qu'un seul fichier: "montreinfo.mpl". Si vous aviez utilisé SELECTMENU directement, vous auriez de changer tous les fichiers qui utilisent l'option 13 du menu 0. SETCOLOR PLOTCOLOR/N/K, AXISCOLOR/N/K, TEXTCOLOR/N/K, AXISCOLORBACK/N/K, TEXTCOLORBACK/N/K, AXISMODE/N/K, TEXTMODE/N/K Change certaines couleurs et modes de traçage. SETCONST NAME/A,DEFINITION/A SETFUNC NUMBER/N/A,DEFINITION/A SETMACRO NAME/A,DEFINITION/A Modifie les definitions. SETINTERVALL XAXIS/N/K,XMIN/K,XMAX/K,YAXIS/N/K,YMIN/K,YMAX/K Defini un nouvel intervalle. SETNUMPRECISION PRECISION/N/A Choisit le nombre de chiffres après la virgule pour NUMINT et EVALSTRING. VERSION VAR/K,STEM/K => VERSION Donne une chaîne contenant la version. Les Macros ARexx ---------------- Pour simplifier certaines actions, vous pouvez écrire des macros (ARexx). Voici un exemple: - Schar Pour tracer par exemple sin(x)+a avec a=1, a=2 et a=3 vous pouvez proceder ainsi: definissez la première fonction comme sin(x)+a. Appelez Schar.mapl. Entrez le numéro de la fonction (0), le nom de la constante (a), le départ et l'arrivée (1,3) et le nombre de pas (3). Les trois fonctions seront tracées. Remerciements ============= J'aimerais remercier quelques personnes: - Commodore pour le Kickstart et le Workbench 2.0 (en particulier pour gadtools.library). - Joern Clausen pour le beta-testing et l'icône du programme. - Michael Balzer pour ARexxBox, grâce auquel MathPlot possède un port ARexx. FIN === Si vous avez des astuces, des questions (ajoutez une enveloppe affranchie a votre adresse pour la réponse svp.), si vous avez repéré des bugs ou si vous voulez payer pour devenir utilisateur officiel, écrivez-moi. Mon adresse se trouve au début de ce document. Amusez-vous bien avec ce programme !! (Traduit de l'anglais par Lionel Sausin)