new math.el

*To*: mathgroup at yoda.physics.unc.edu*Subject*: new math.el*From*: jacobson at cello.hpl.hp.com*Date*: Thu, 16 Jan 92 17:02:00 PST

Here is a new revision of math.el for Mathematica version 2.0. It provides a mode for running Mathematica under Gnu Emacs to achieve functionality somewhat similar to the notebook interface available on the Macintosh. It maintains compatibility with 1.2 whereever possible. I've added a command C-c C-k that will kill an unwanted cell. Also the remote execution facility now sets the DISPLAY variable on the remote host. -- David Jacobson =============== ;; math.el, a mode package for Mathematica. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; Copyright (c) 1990, 1991, 1992 Hewlett-Packard Company, all rights reserved. ;; ;; LEGAL NOTICE ;; ;; This math-mode package is experimental and HP shall have no obligation to ;; maintain or support it. HP makes no express or implied warranty of any ;; kind with respect to this software, and HP shall not be liable for any ;; direct, indirect, special, incidental or consequential damages (whether ;; based on contract, tort or any other legal theory) arising in any way from ;; use of the software. ;; ;; Everyone is granted permission to copy, modify and redistribute this ;; math-mode package, provided: ;; 1. All copies contain this copyright notice. ;; 2. All modified copies shall carry a prominant notice stating who ;; made the last modification and the date of such modification. ;; 3. No charge is made for this software or works derived from it. ;; This clause shall not be construed as constraining other software ;; distributed on the same medium as this software, nor is a ;; distribution fee considered a charge. ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; Portions of this package were adapted from GNU Emacs. ;; ;; Copyright (C) 1985, 1986, 1987, 1988 Free Software Foundation, Inc. ;; ;; GNU Emacs is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY. No author or distributor ;; accepts responsibility to anyone for the consequences of using it ;; or for whether it serves any particular purpose or works at all, ;; unless he says so in writing. Refer to the GNU Emacs General Public ;; License for full details. ;; Everyone is granted permission to copy, modify and redistribute ;; GNU Emacs, but only under the conditions described in the ;; GNU Emacs General Public License. A copy of this license is ;; supposed to have been given to you along with GNU Emacs so you ;; can know your rights and responsibilities. It should be in a ;; file named COPYING. Among other things, the copyright notice ;; and this notice must be preserved on all copies. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; Author: David Jacobson, jacobson at hplabs.hp.com ;; Assumes GNU Emacs version 18.54 or later ;; Version info is in math-version-string defined after history box ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; 2/17/1991 Dan Dill dan at chem.bu.edu ;; Add math-send-filter-active and math-send-filter-status, ;; for use with tex-mma ;; ;; 5/1/1991 Dan Dill dan at chem.bu.edu ;; Add math-remote-host and math-remote-shell and modified ;; start-buffer-process, to run Mathematica remotely ;; ;; 5/8/1991 David Jacobson jacobson at hplabs.hp.com ;; Add math-timeout and improve documentation, add checking ;; for incomplete cells to check-math-syntax ;; ;; 11/17/1991 David Jacobson jacobson at hpl.hp.com ;; Adding indent cookie crumb rejection ;; ;; 11/27/1991 David Jacobson jacobson at hpl.hp.com ;; Fix path. Delete goto-math-line. Fix up find-math-error ;; ;; 11/30/1991 Dan Dill dan at chem.bu.edu ;; Adapt indent cookie crumb rejection changes for use with tex-mma ;; ;; 12/5/91 David Jacobson jacobson at hpl.hp.com ;; Functions math and start-math no longer call math-mode if it was already ;; in math-mode. (math-mode initializes a lot of variables, including ;; all local variables.) Small changes to start-buffer-process to avoid ;; munging state if the process is already running. ;; ;; 12/10/91 David Jacobson jacobson at hpl.hp.com ;; Add kill-math-cell. Add installation instructions. Fix documentation. ;; ;; 12/12/91 Dan Dill dan at chem.bu.edu ;; Synchronize with tex-mma by setting math-send-filter-active to nil ;; in math-send-filter when the input prompt has been received. ;; ;; 12/17/91 David Jacobson jacobson at hpl.hp.com ;; Set mark when C-c C-y copies cell. Fix bug causing ;; C-c C-y and empty response in last cell of buffer that ;; was not its own math process buffer to get wrong cell. ;; Rename start-buffer-process to start-math-process. ;; Add more documentation. Add math-mode-load-hook. ;; ;; 12/31/91, 1/7/92 David Jacobson jacobson at hpl.hp.com ;; Cause the DISPLAY variable to be set when using a remote host. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (defconst math-version-string "Mathematica mode experimental version of January 7, 1992 for Mathematica version 2.0" "String describing this version of math.el.") ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; Installation and use: ;; ;; For initial tryout save this file somewhere, start emacs and type ;; M-x load-file <<the full path name of this file>> ;; Then type ;; M-x math ;; a window should be created and a Mathematica process created in it. ;; Type in a cell and "submit" it with ESC-RET. ;; You can see a lot more information and instructoins by typing ;; C-h m (DEL m for HP keyboard users). ;; You can use C-h f to find more information on each command. ;; ;; For full installation, this file should be installed as math.el ;; in whatever directory you put your local or personal emacs lisp files. ;; It should be byte-compiled. You should add the following to ;; your .emacs file: ;; ;; (autoload 'math "math" "Starts Mathematica" t) ;; (autoload 'math-mode "math" ;; "Mode for editing Mathematica. Loading will result in more info." t) ;; (setq auto-mode-alist (cons '("\\.m" . math-mode) auto-mode-alist)) ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; ;; LIMITATIONS ;; ;; A nasty problem arises because's in Version 2.0 Mathematica will under ;; certain conditions put out a message before a cell has been completed, ;; then expect the remainder of the cell to be sent. In most other ;; conditions, unexpected output indicates an error of one sort or ;; another has occurred. Two such messages are General::spell, ;; indicating a suspected spelling error, and Syntax::newl, indicating ;; that a newline has been interpreted as a multiplication operator. ;; ;; There are several approaches to this problem: ;; 1. Avoid the constructs that lead to it. ;; 2. Turn off the messages. ;; 3. Persuade WRI to change the interface. ;; 4. Workaround it. When it occurs ;; a. Move to a blank line and type ESC RET. This will send a newline ;; to the Mathematica process and cause it to flush its input ;; and reissue the prompt. ;; b. Cut away the message and new prompt. ;; c. Fix the input, if necessary (it is not necessary for ;; General::Spell), and resubmit the cell. ;; ;; The whole system for running Mathematica on a remote host is rather ;; unreliable. If the built-in facilities don't work, try setting ;; math-process-string to point to a shell script (or compiled program,for ;; that matter), which you can then work with freely. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; (provide 'math) (require 'shell) (defvar Mathematica-search-path (list nil (getenv "HOME") "/usr/local/math/StartUp" "/usr/local/math/Packages") "*A list of directories in which to look for files. Use nil for the current directory.") (defvar math-process-string "/usr/local/bin/math" "*A string to pass to the unix exec function to start Mathematica") (defvar math-process-buffer "*math*" "The buffer normally running Mathematica. Certain commands (e.g. math-complete-symbol) will go to this buffer to find a Mathematica process. This can be locally set with set-math-process-buffer.") (defconst math-header-re (concat "^" (regexp-quote "Copyright 1988-91 Wolfram Research, Inc.")) "A regexp that will match somewhere in the Mathematica preamble") (defvar math-remote-host nil "*If non-nil, use as remote host name with `math-remote-shell' to run Mathematica remotely.") (defvar math-remote-display-var nil "*If set to a string, the DISPLAY environment variable on the remote host is set to this value. If nil, the DISPLAY environment variable on the remote host is set the the local DISPLAY environment variable. If math-remote-display-var is neither nil nor a string, the DISPLAY environment variable on the remote host will not be set. This variable is ignored if math-remote-host is nil.") (defvar math-timeout nil "*If non-nil, use as a timeout between lines of input. Nil is recommended, unless you are having trouble with the system hanging, particularly on syntax errors. Nil causes input to be waited for using accept-process-output. This means the next line of output will be sent when math-mode receives the indentation prompt from Mathematica. If non-nil math-mode will wait only math-timeout seconds between sending lines of input. Usually this needs to be set when using a remote host. 1 is recommended in this case. (See math-remote-host and math-remote-shell.)") (defvar math-remote-shell (cond ((file-exists-p "/usr/ucb/rsh") "/usr/ucb/rsh") ((file-exists-p "/usr/bin/remsh") "/usr/bin/remsh")) "*String used with `math-remote-host' to run Mathematica remotely.") (defconst math-valid-cell-ending-re ".*\\([])}\"A-Za-z0-9!_'$%#]\\|\\+\\+\\|--\\|=[ \t]*\\.\\|[^/];\\|\\b[0-9]+\\.\\|[^&]&\\)[ \t]*$" "An re that matches lines that can validly end complete cells. This is not perfect.") ;;; The "[^/];" is because "/;" means a condition follows, so it cannot ;;; be the end of a cell. The "=[ \t]*\\." and "\\b[0-9]+\\." allow periods ;;; only in "=." and at the end of mumbers, disallowing a ;;; variable followed by a period (Dot[]). "[^&]&" allows "&" but not "&&". ;;; It will mess up if "&" appears ;;; as the first character on a line by itself, but then the end of the ;;; previous line probably made a valid prefix, which is an error anyway. (defvar math-send-filter-status 'normal "Status of last input to Mathematica: `normal' means no problems detected; `input-prompt' means Mathematica input prompt received `premature-output' means part of cell not sent due to unexpected output; `blank-line-added' means line inserted to separate input from output; `incomplete-cell' means an incomplete cell was detected; `syntax-error' means a syntax error was detected.") (defvar math-send-filter-active nil "Status of Mathematica process filter: t if enabled, else nil.") (defvar math-last-output-column 8 "The column at which the last \"normal\" output ended. Indent cookies are considered complete if they are this long.") (defvar math-mode-map nil) ;;; deep-copy-keymap was written by Daniel LaLiberte. ;;; Some GNU Emacs systems already have this installed. If so ;;; comment out this function definition. (defun deep-copy-keymap (keymap) "Return a deep copy of KEYMAP. That is, all levels are copied, not just the top level." (if (not (keymapp keymap)) keymap (cond ((listp keymap) (let ((new-keymap (copy-alist keymap))) (setq keymap (cdr new-keymap)) (while keymap (let ((binding (car keymap))) (if (keymapp (cdr binding)) (setcdr binding (deep-copy-keymap (cdr binding)))) ) (setq keymap (cdr keymap)) ) new-keymap )) ((vectorp keymap) (let ((i 0) (n (length keymap)) (new-keymap (copy-sequence keymap))) (while (< i n) (if (keymapp (aref keymap i)) (aset new-keymap i (deep-copy-keymap (aref keymap i)))) (setq i (1+ i))) new-keymap ))))) (defun math-version () "Display string indentifying math.el." (interactive) (with-output-to-temp-buffer "*Help*" (print-help-return-message)) (let ((home-buffer (current-buffer))) (pop-to-buffer "*Help*") (insert math-version-string) (insert "\n") (pop-to-buffer home-buffer)) (bury-buffer "*Help*")) (if math-mode-map nil (setq math-mode-map (deep-copy-keymap shell-mode-map)) (define-key math-mode-map "\C-m" 'newline) ; The shell-mode-mode ; sets this to shell-send-input. ; We change it to 'newline. We ; ought to undefine it, so that ; Emacs will find the 'newline ; in the global keymap, but there ; is no easy way to do this. (define-key math-mode-map "\e\C-m" 'math-send-input) ;; \C-c\C-c is set to interrupt-shell-subjob in the shell-mode-mode ;; The name is deceptive; it sends a SIGINT signal (control C) to ;; whatever process is running in the current buffer (define-key math-mode-map "\C-c9" 'kill-9-process) (define-key math-mode-map "\C-cv" 'math-version) ;(define-key math-mode-map "\C-c\C-h" 'math-help); buffer specific C-h (define-key math-mode-map "\C-he" 'math-help) ; e-xpression in help menu (define-key math-mode-map "\C-hE" 'math-extra-help) ; E-xpression in help menu (define-key math-mode-map "\C-c\C-f" 'math-edit-function) (define-key math-mode-map "\e\t" 'math-complete-symbol) (define-key math-mode-map "\C-c\C-y" 'math-copy-cell) (define-key math-mode-map "\C-c\C-e" 'find-math-error) (define-key math-mode-map "\C-c\C-r" 'math-isearch-backward) (define-key math-mode-map "\C-c\C-k" 'kill-math-cell) ) (defvar math-mode-syntax-table nil "Syntax table used while in math mode.") (if math-mode-syntax-table () (setq math-mode-syntax-table (make-syntax-table)) (modify-syntax-entry ?% "." math-mode-syntax-table) (modify-syntax-entry ?& "." math-mode-syntax-table) (modify-syntax-entry ?* ". 23" math-mode-syntax-table) ;allow for (* comment *) (modify-syntax-entry ?+ "." math-mode-syntax-table) (modify-syntax-entry ?- "." math-mode-syntax-table) (modify-syntax-entry ?/ "." math-mode-syntax-table) (modify-syntax-entry ?< "." math-mode-syntax-table) (modify-syntax-entry ?= "." math-mode-syntax-table) (modify-syntax-entry ?> "." math-mode-syntax-table) (modify-syntax-entry ?_ "." math-mode-syntax-table) (modify-syntax-entry ?\| "." math-mode-syntax-table) (modify-syntax-entry ?\` "_" math-mode-syntax-table) ; Mathematica context symbol (modify-syntax-entry ?\( "()1" math-mode-syntax-table) ;allow for (* comment *) (modify-syntax-entry ?\) ")(4" math-mode-syntax-table)) ;allow for (* comment *) ;;; math-send-input sends a chunk of text to Mathematica. It ;;; interacts tightly with math-send-filter using the buffer-specific ;;; variable math-send-state and synchronizes though sending output ;;; and the accept-process-output (but see below) command. ;;; The Emacs documentation ;;; claims that one cannot be sure how much output will be delivered ;;; in a chunk to the output filter. However we depend on chunks of ;;; up to one line after which Mathematica immediately does a read, ;;; arriving in a single chunk. A slightly more robust technique than ;;; doing string-match on the input string would be to put the input ;;; into the buffer and match there. ;;; If the Mathematica process does not send a prompt at all, the ;;; accept-process-output hangs and the only solution is to kill the ;;; mathexe process or Emacs. This can happen if you use an Input[""] ;;; (a rather perverse thing to do). An alternative is to replace ;;; (accept-process-output process) with (sleep-for 10). It appears that ;;; arrival of any output causes Emacs to pop immediately out of a ;;; sleep-for. But this could mess up if you have more than one active ;;; process running at a time or if you strike a key. ;;; Of course, we could use a while loop and have the filter set ;;; math-send-state to another value when it has actually gotten ;;; something. I tried this but ran into unknown trouble and have ;;; not followed up on it. ;;; The variable math-send-state has the following interpretatons: ;;; non-last-line We are in the middle of sending a ;;; multi-line input. Watch for ;;; errors and output other than indent ;;; cookies. ;;; ;;; last-line The last line has been sent, still watch ;;; for syntax error messages. Also insert ;;; a blank like (and warn about it) if the ;;; output contained any non-whitespace ;;; characters before a newline. ;;; ;;; premature-output Output arrived when we were expecting ;;; an indent cookie. ;;; ;;; throw-away-prompt A syntax error has been detected and a ;;; newline sent to Mathematica to flush its ;;; input buffer. Normally it will come ;;; back with a new prompt. If the next ;;; output looks like a prompt, throw it ;;; away and give a syntax error message. ;;; Throw away indent cookies. ;;; Otherwise display the discarded ;;; material in a warning message. ;;; ;;; normal Just post the output. ;;; Note: the syntax error detection code and the correspoinding ;;; throw-away-prompt state were important in 1.2. They should ;;; be unnecessary in 2.0, but were left for compatibility. ;;; No attempt has been made in upgrading to 2.0 to maintain full backward ;;; compatibility, but the basic cell-submission stuff is so important ;;; that backward compatibility is attempted here. (defvar math-partial-output "" "Accumulates output until it can be determined that it is not an indent cookie") (defun indent-cookie-p (string) "Checks STRING to see if it is an indent cookie. Returns t if probably a cookie, nil if definitely not, and 'partial otherwise. It is not really a predicate of STRING, since it also depends on math-send-state." (if (memq math-send-state '(last-line non-last-line)) (if (string-match "\\` +\\'" string) (let ((len (length string))) (cond ((< len math-last-output-column) 'partial) ((= len math-last-output-column) t) (t nil))) ; too long nil) ; non-blank nil)) ; not correct state (defvar math-indent-cookie-pending nil "t if we can't decide if we have an indent cookie.") (defun math-send-input () "Send input to Mathematica. At end of buffer, sends last \"cell\" to Mathematica. When not at end, copies current \"cell\" to the end of the buffer and sends it. Also sends input for interrupt and Input[]. Warning: A multi-line input to Input[\"\"] will cause deadlock." (interactive "*") (let ((process (or (get-buffer-process (current-buffer)) (error "Current buffer has no process"))) bpt2 ept2 begpkt endpkt copy ) ;; Find beginning of "cell" (let* ((cellinfo (math-identify-cell (point) (process-mark process))) (bpt (car cellinfo)) (ept (nth 1 cellinfo)) ) (check-math-syntax bpt ept) (goto-char ept) ;; Move to line beyond cell, adding newline if necessary. (forward-line 1) (if (or (not (bolp)) (= (point) bpt)) ; make null cells contain a newline (newline)) (setq copy (buffer-substring bpt (point))) ;; If we are \"near\" the end of the buffer, we don't copy the data down ;; there, but we kill excess white space. Otherwise, we go there and ;; copy the data. (if (looking-at "\\s *\\'") (progn (replace-match "") (setq bpt2 bpt) (setq ept2 (point)) (setq math-last-input-end (point))) (push-mark bpt) ; This sets the mark when copying down a cell (goto-char (point-max)) (forward-line 0) (if (or (eolp) (looking-at "^[ \t]*In\\[[0-9]+\\]:=\\s *$")) (end-of-line) (end-of-line) (newline)) (setq bpt2 (point)) (insert copy) (setq ept2 (point)) (setq math-last-input-end (point))) (goto-char bpt2) (setq math-partial-output "") (setq math-indent-cookie-pending nil) (setq math-send-filter-status 'normal) ; For single line input without filter ; .. (set-process-filter process 'math-send-filter) ;; math-send-state is a global variable (setq math-send-state 'non-last-line) (setq begpkt bpt2) ; point (message "*") (unwind-protect (while (eq math-send-state 'non-last-line) (goto-char begpkt) (forward-line 1) (setq endpkt (point)) (if (= endpkt ept2) (setq math-send-state 'last-line)) (metered-process-send-string process (buffer-substring begpkt endpkt)) (if (eq math-send-state 'non-last-line) (if math-timeout (sleep-for math-timeout) (accept-process-output process) (while math-indent-cookie-pending (accept-process-output process)))) (cond ((eq math-send-state 'premature-output) (setq math-send-state 'normal) ; for unwind protect (error "Unexpected output; part of cell discarded"))) (setq begpkt endpkt) ; advance to next line ) ; end while ;; unwind-protect tail ;;; (setq math-send-filter-active nil); syncrhonize with tex-mma )))) (defun math-send-filter (proc procstring) (let ((cbuf (current-buffer)) (save-match-data (match-data)) (string (concat math-partial-output procstring))) (unwind-protect (progn (setq math-partial-output "") (setq math-indent-cookie-pending nil) ; assume for now this ouput ;completes an indent cookie (set-buffer (process-buffer proc)) (cond ;; cond branch: can not tell if it is or is not an indent cookie ((eq (indent-cookie-p string) 'partial) (setq math-partial-output string) (setq math-indent-cookie-pending t)) ;; cond branch: a <retype-line error> ;; retained for version 1.2 compatibility ((and (memq math-send-state '(non-last-line last-line)) (string-match "\\`\\([ \t]*\\)\\^ <retype line>" string)) (let ((tpt (point)) error-column indent-column (tail-string (substring string (match-end 0)))) (goto-char tpt) (insert (substring string 0 (match-end 1))) (setq error-column (current-column)) (delete-region tpt (point)) (indent-to-column (- error-column math-last-output-column)) (insert "^--error\n") (backward-char 9) (previous-line 1) ;; Display any unexpected output. I don't know how to ;; test this code. (if (string-match "\\S " tail-string) (save-excursion (goto-char (point-max)) (insert tail-string)))) ; end of let (setq math-send-state 'throw-away-prompt) (message "Syntax error") ; live dangerously here, but sometimes we ; don't get a prompt back from ; Mathematica (process-send-string proc "\n") (setq math-send-filter-status 'syntax-error) ) ;; cond branch: snarf up indent strings ;; Whether or not this branch is taken when math-send-state ;; is throw-away-prompt depends on the OS. On some systems ;; the indent cookie comes out with the "^ <retype-line>" ;; (in 1.2 only) ;; and the indent cookie is inserted by the tail-string ;; procesing above. On others it comes out separately and is ;; handled here. ((and (memq math-send-state '(non-last-line throw-away-prompt)) (eq (indent-cookie-p string) t))) ; do nothing ;; cond branch: unexpected output ((eq math-send-state 'non-last-line) (insert "-------- Unexpected output appeared here; rest of cell not sent --------\n" ) (goto-char (point-max)) (insert string) (setq math-last-output-column (current-column)) (set-marker (process-mark proc) (point)) (setq math-send-state 'premature-output) (message "") (setq math-send-filter-status 'premature-output) ) ;; cond branch: throw away unwanted prompt ((eq math-send-state 'throw-away-prompt) (setq math-send-state 'normal) (if (string-match "\\`[ \t]*In\\[[0-9]+\\]:= \\'" string) (message "Syntax error") (message "Syntax error, discarding prompt(?): %s" string)) (setq math-send-filter-status 'syntax-error) ) ;; cond branch: last line has been sent, make sure a blank line ;; follows the In... stuff. See further comments. ((eq math-send-state 'last-line) (goto-char (point-max)) (cond ((string-match "\\`\\s *\n" string); blank with newline (message "") ) ; clear "*" in message area ((eq (indent-cookie-p string) t) ; give help message (message "Incomplete cell? (Clear with RET ESC RET)") (setq math-send-filter-status 'incomplete-cell) ) ((string-match "\\`[ \t]*In\\[[0-9]+\\]:=" string) (message "") ; clear "*" in message area (setq math-send-filter-status 'normal) ) (t ;; non-blank, but not an In[] prompt. Probably either ;; output of a Mathematica Print[...] or an error message. ;; Add a blank line to separate cells. (newline) (message "newline inserted by Emacs' math-mode") (setq math-send-filter-status 'blank-line-added) )) (insert string) (setq math-last-output-column (current-column)) (set-marker (process-mark proc) (point)) (setq math-send-state 'normal) ) ;; cond branch. all else fails. This is the normal case (t (setq math-send-state 'normal) ;;; (setq math-send-filter-status 'normal) (goto-char (point-max)) (insert string) (setq math-last-output-column (current-column)) (set-marker (process-mark proc) (point))) )) ; finishes up cond and progn ;; safely exit the filter (save-excursion (beginning-of-line) (if (looking-at "^In\\[[0-9]+\\]:= ") (setq math-send-filter-active nil) ; Synchronize with tex-mma )) (set-buffer cbuf) (store-match-data save-match-data)))) (defun math-mode () "Major mode for interacting with Mathematica and editing .m files. \\[math] starts Mathematica. (See below for starting Mathematica on a remote host.) \\[math-send-input] tries to identify stuff following last \"In[...]:= \" or blank line or the last output and sends it. To clear out Mathmatica after an error occurs, move point two lines below last printing character and type \\[math-send-input]. Warning: do not use Input[\"\"], and type in a mult-line reply; deadlock results. \\[math-help] gives help on a Mathematica symbol. With wildcards it lists all matching symbols. \\[math-extra-help] or C-u \\[math-help] gives more verbose help. \\[math-complete-symbol] will complete the symbol near point. \\[math-copy-cell] will copy a previous cell to the end of the buffer. See its description for details. \\[math-isearch-backward] does a backward regexp i-search, initialized to find In[...]. \\[kill-math-cell] kills the cell near point. \\[find-math-error] when typed after <<filename has returned a syntax error will goto the error. (Depends on Mathematica-search-path.) \\[interrupt-shell-subjob] interrupts Mathematica. \\[kill-9-process] kills (-9) the Mathematica process. \\[start-math] starts a Mathematica process in the current buffer. \\[math-version] identifies this version of Mathematica mode. Most entries from the Emacs' shell mode are available as well. If you are not in a buffer running Mathematica, \\[math-help], \\[math-extra-help], \\[math-complete-symbol], and \\[math-copy-cell] use or copy to the buffer *math*. \\[math-help], \\[math-extra-help], and \\[math-complete-symbol] all send input to Mathematica: chaos may ensue if you do this while Mathmatica is busy with other work---no check is made. You can change the buffer/process these commands use with \\[set-math-process-buffer]. Entry to this mode calls the value of math-mode-hook with no args, if that value is non-nil. If variable math-remote-host is non-nil, \\[math] will start Mathematica on host math-remote-host using command in math-remote-shell, which defaults to \"/usr/ucb/rsh\", or \"/usr/bin/remsh\" if the first is not available. If you have trouble with math-mode hanging for multi-line input, see the help on the variable math-timeout. Due to a Mathematica feature you should submit $BatchInput = False Interrupts are not available when using a remote host, and synchronization is sometimes incorrect; sorry. See also the variable math-remote-display-var." (interactive) (kill-all-local-variables) (setq major-mode 'math-mode) (setq mode-name "Mathematica") (setq mode-line-process '(": %s")) (use-local-map math-mode-map) (set-syntax-table math-mode-syntax-table) (make-local-variable 'parse-sexp-ignore-comment) (setq parse-sexp-ignore-comment t) (make-local-variable 'math-last-output-column) (make-local-variable 'math-send-state) (setq math-send-state 'normal) (make-local-variable 'doing-math-complete-symbol) (setq doing-math-complete-symbol nil) ; Position of end of last input to Mathematica (make-local-variable 'math-last-input-end) (run-hooks 'math-mode-hook)) (defun math () "Run Mathematica, input and output via buffer *math*." (interactive) (pop-to-buffer (start-math-process "*math*" "math" math-process-string nil)) (if (not (eq major-mode 'math-mode)) (math-mode)) ;; We don't make this one local. That way if the ;; user changes the name of the buffer, say by writing ;; it to a file, math-process-buffer still points ;; to the right place. (setq math-process-buffer (current-buffer)) (set-process-filter (get-buffer-process math-process-buffer) 'math-send-filter)) (defun start-math () "Starts a Mathematica process in the current buffer." (interactive "*") (start-math-process (current-buffer) "math" math-process-string nil) (if (not (eq major-mode 'math-mode)) (math-mode)) (make-local-variable 'math-process-buffer) (setq math-process-buffer (current-buffer)) (set-process-filter (get-buffer-process math-process-buffer) 'math-send-filter)) (defun math-complete-symbol () "Complete the symbol preceeding point." (interactive "*") (let ((process (get-buffer-process math-process-buffer)) sent-successfully) (if (not (and process (memq (process-status process) '(run stop)))) (error "No math process running in buffer %s" math-process-buffer)) (setq math-completion-symbol (math-symbol-around-point)) (unwind-protect (let ((cbuf (current-buffer))) (set-buffer (get-buffer-create " Mathwork")) (erase-buffer) (set-buffer cbuf) (setq doing-math-complete-symbol t) (set-process-filter process 'math-help-filter) (process-send-string process (concat "Scan[Print,Names[\"" math-completion-symbol "**\"]];Out[--$Line];\n")) (setq sent-successfully t)) (if (not sent-successfully) (progn (setq doing-math-complete-symbol nil) (setq math-send-state 'normal) ; IS THIS RIGHT (set-process-filter process 'math-send-filter)))))) (defun math-symbol-around-point () "Return the symbol around the point as a string." (save-excursion (let (beg) (if (not (eobp)) (forward-char 1)) (if (not (re-search-backward "\\w\\|\\s_" nil t)) "" (forward-char 1) (backward-sexp) (setq beg (point)) (forward-sexp) (buffer-substring beg (point)))))) (defun math-extra-help () "Like math-help with a prefix arg" (interactive) (let ((current-prefix-arg (list 1)) (prefix-arg (list 1))) ; I'm hacking. ; current-prefix-arg makes M-X ... work ; prefix-arg makes it work when bound to a key ; I'm sure RMS had something else in mind. (call-interactively 'math-help))) (defun math-help (symbol arg) "Display what Mathematica knows about SYMBOL. With prefix arg (2nd arg when called from a program) it gives more info." (interactive ; read a word, using the word around point as the default (let ((enable-recursive-minibuffers t) (try-word (math-symbol-around-point)) val) (if (string-equal try-word "") (setq val (read-string "Mathematica symbol: ")) (setq val (read-string (format "Mathematica symbol (default %s): " try-word))) (if (string-equal val "") (setq val try-word))) (if (string-equal val "") (error "No symbol read")) (list val current-prefix-arg))) (let ((process (get-buffer-process math-process-buffer)) sent-successfully) (if (not (and process (memq (process-status process) '(run stop)))) (error "No math process running in buffer %s" math-process-buffer)) (unwind-protect (progn (with-output-to-temp-buffer "*Help*" (print-help-return-message)) (set-process-filter process 'math-help-filter) (process-send-string process (concat (if arg "??" "?") symbol "\n")) (setq sent-successfully t)) (if (not sent-successfully) (set-process-filter process 'math-send-filter))))) (defun math-edit-function (symbol arg) "Display all of SYMBOL's definitions in InputForm" (interactive ; read a word, using the word around point as the default (let ((enable-recursive-minibuffers t) (try-word (math-symbol-around-point)) val) (if (string-equal try-word "") (setq val (read-string "Mathematica symbol: ")) (setq val (read-string (format "Mathematica symbol (default %s): " try-word))) (if (string-equal val "") (setq val try-word))) (if (string-equal val "") (error "No symbol read")) (list val current-prefix-arg))) (let ((sent-successfully) (process (get-buffer-process math-process-buffer)) (cbuf (current-buffer))) (unwind-protect (progn (set-buffer (get-buffer-create " Mathwork")) (erase-buffer) (set-buffer cbuf) (set-process-filter process 'math-edit-function-filter) (process-send-string process (concat "Print[HoldForm[Clear[" symbol "]]];Definition[" symbol "]//InputForm\nPrint[\"asdfasdfasdfasdf\"];Out[$Line -= 2];\n")) (setq sent-successfully t)) (if (not sent-successfully) (set-process-filter process 'math-send-filter))))) (defun math-edit-function-filter (proc string) (let ((cbuf (current-buffer)) (save-match-data (match-data)) ) (unwind-protect (progn (set-buffer " Mathwork") (goto-char (point-max)) (insert string) (forward-line 0) (if (and (looking-at "[ \t]*In\\[[0-9]+\\]" ) (re-search-backward "\\(\\S \\)\\s *In\\[[0-9]+\\]:= asdfasdfasdfasdf" nil t)) (let ((separator "")) ; separator puts things ; like (*=============*) between the defintions. ; but the more I looked at it the more less-cluttered looked ; better. Feel free to change it to whatever you like. (set-process-filter proc 'math-send-filter) (delete-region (match-end 1) (point-max)) (goto-char (point-max)) (if (not (re-search-backward "Out\\[[0-9]+\\]//InputForm=" nil t)) (error "Math mode internal error")) (delete-region (match-beginning 0) (match-end 0)) (if (looking-at "\\s *\\'") ; blank to eob (progn ; extract name of function (goto-char (point-min)) (re-search-forward "Clear\\[\\([^]]+\\)\\]") (error "Function %s not defined" (buffer-substring (match-beginning 1) (match-end 1))))) (if (looking-at "\\s *Attributes\\[.+\\] =") (progn (forward-sexp) (end-of-line) (newline))) (goto-char (point-min)) (insert "(") (goto-char (point-max)) (insert "\n;" separator ")\n") (goto-char (point-min)) (replace-regexp "^\\([ \t]*\n\\)+" (concat ";" separator "\n")) (goto-char (point-max)) (set-buffer cbuf) (insert-buffer " Mathwork") (forward-line 2))) ) ;; Unwind protect tail (set-buffer cbuf) (store-match-data save-match-data)))) (defun math-help-filter (proc string) (let ((cbuf (current-buffer)) (save-match-data (match-data)) (local-doing-math-complete-symbol doing-math-complete-symbol) (c-process-filter (process-filter proc))) ;; doing-math-complete-symbol is buffer-local and we are going ;; to switch buffers. (unwind-protect (progn (if local-doing-math-complete-symbol (set-buffer " Mathwork") (set-buffer "*Help*")) (goto-char (point-max)) (insert string) (beginning-of-line) (if (looking-at "^[ \t]*In\\[[0-9]+\\]:=") (progn (delete-region (point) (point-max)) (bury-buffer (current-buffer)) (set-process-filter proc 'c-process-filter) (if local-doing-math-complete-symbol (progn (set-buffer cbuf) ;; we are back to the original buffer, so this is ok (setq doing-math-complete-symbol nil) (insert (get-math-completion math-completion-symbol))) (goto-char (point-min)))))) (set-buffer cbuf) (store-match-data save-match-data)))) (defun check-math-syntax (pmin pmax) "Checks for balanced parens, lack of valid prefix, and valid termination. Mathematica will misbehave if there exists a prefix of a cell such that the prefix ends in a newline and forms a valid mathematica expresssion. This function causes an error if that is the case. If that is ok it checks that the whole expression has balanced parens, comments and quotes. It is not perfect at these checks since GNU Emacs does not understand nested comments. Also it only checks that the nesting level of all paren constructs is zero at the end, not that they really match." (interactive "r") (let ((pt (point)) possibleerr) (save-restriction (narrow-to-region pmin pmax) (goto-char pmin) (while (and (not possibleerr) (not (eobp))) (end-of-line) (let ((parsestate (parse-partial-sexp (point-min) (point)))) (if (not (looking-at "\\s *\\'")) ; not just all white space to eob (progn ; make sure this could NOT end a valid expression (if (and (= (nth 0 parsestate) 0) ; zero paren depth (not (nth 3 parsestate)) ; not in a string (not (nth 4 parsestate)) ; not in a comment (progn (forward-line 0) (looking-at math-valid-cell-ending-re))) (progn (setq possibleerr "Possible complete statement before end, submit anyway? ") (end-of-line)))) ;; we are at the end of the statement (cond ((nth 3 parsestate) (setq possibleerr "Apparently unterminated string, submit anyway? ")) ((nth 4 parsestate) (setq possibleerr "Apparently unclosed comment, submit anyway? ")) ((not (zerop (nth 0 parsestate))) (setq possibleerr "Apparently mismatched parens, submit anyway? ")) ((save-excursion (forward-line 0) (not (looking-at math-valid-cell-ending-re))) (setq possibleerr "Possible incomplete cell, submit anyway? ")))) (if (not possibleerr) (forward-line 1))))) (if (and possibleerr (not (y-or-n-p possibleerr))) (progn (error "Cancelled") (setq math-send-filter-status 'syntax-error) ) (goto-char pt)))) (defun start-math-process (bufferid procname program &optional startfile &rest switches) ;; A munged version of make-shell ;; bufferid can be a buffer or the name of a buffer ;; startfile is now ignored. ;; It wouldn't have worked with Mathematica anyway. (let ((buffer (get-buffer-create bufferid)) (disp (or math-remote-display-var (getenv "DISPLAY"))) proc proc-args proc-more-args status size) (setq proc (get-buffer-process buffer)) (if proc (setq status (process-status proc))) (save-excursion (set-buffer buffer) ;; (setq size (buffer-size)) (if (memq status '(run stop)) nil (if proc (delete-process proc)) (message "Starting Mathematica...") (setq proc-args (list procname buffer (concat exec-directory "env") (format "TERMCAP=emacs:co#%d:tc=unknown:" (screen-width)) "TERM=emacs" "EMACS=t" "-" )) (setq proc-more-args (list program)) (if switches (setq proc-more-args (append proc-args switches))) (cond ((not math-remote-host) (setq proc-args (append proc-args proc-more-args))) ((stringp disp) (setq proc-args (append proc-args (list math-remote-shell) (list math-remote-host) (list "sh") (list "-c") (list (format "\"DISPLAY=%s %s\"" disp (mapconcat 'identity proc-more-args " ")))))) (t (setq proc-args (append proc-args (list math-remote-shell) (list math-remote-host) proc-more-args)))) (setq proc (apply 'start-process proc-args)) (setq procname (process-name proc)) ; what in the world is this for? (goto-char (point-max)) (set-marker (process-mark proc) (point)) (shell-mode))) buffer)) (defun backward-incarnations (inc) "Moves back ARG incarnations of Mathematica, as recognized by math-header-re." (if inc (let ((count (cond ((numberp inc) inc) ((equal inc '(4)) 1) ((equal inc '(16)) 2) ((equal inc '(64)) 3) ((equal inc '(256)) 4) ((equal inc '(1024)) 5) (t (error "I'm too lazy to count that many prefix keys"))))) (re-search-backward math-header-re nil nil count)))) (defun math-copy-cell (numberstring incarnations pt) "Copies the cell beginning In[<CELLNUMBER>] to the end of the buffer. With CELLNUMBER of empty string and point at or after last In[...]:= (and if buffer is its own math-process-buffer) copies previous In cell to end of buffer. With point before last In[...]:= copies cell near point (In, Out, or just a block of text) to end of buffer. With an explicit CELLNUMBER, a prefix arg will skip back prefix arg incarnations before searching for In[<CELLNUMBER>]. C-u's count in unary. When called from a program, CELLNUMBER must be a string, second arg is INCARNATIONS back and third is POINT to begin search at." (interactive "sCell number (default is cell near point): \nP\nd") (cond ((zerop (length numberstring)) (goto-char (point-max)) (if (and (equal (get-buffer math-process-buffer) ; get-buffer is safe ; in wierd cases (current-buffer)) ; copy to ourself? (re-search-backward "^[ \t]*In\\[[0-9]+\\]:=" nil t) (>= pt (point))) ; in or after last cell (progn (re-search-backward "^[ \t]*In\\[[0-9]+\\]:=") ; back up to previous one (while (and (not (bobp)) (or (looking-at ; reject ones without any useful text "^[ \t]*In\\[[0-9]+\\]:=\\s *\\(\\'\\|\n\\s *$\\)"))) (re-search-backward "^[ \t]*In\\[[0-9]+\\]:="))) (goto-char pt))) ; else branch: do current cell (t (goto-char (point-max)) (backward-incarnations incarnations) (re-search-backward (concat "^[ \t]*In\\[" numberstring "\\]:=")))) (if (interactive-p) (push-mark)) (let* ((cellinfo (math-identify-cell (point) nil t)) (copy (buffer-substring (car cellinfo) (nth 1 cellinfo)))) (if (not (equal (get-buffer math-process-buffer) (current-buffer))) (pop-to-buffer math-process-buffer)) (goto-char (point-max)) (re-search-backward "\\S ") (forward-line 0) (if (looking-at "^[ \t]*In\\[[0-9]+\\]:=\\s *$") (end-of-line) (goto-char (point-max))) (insert copy))) (defun math-isearch-backward () "Does a backward regexp i-search, initialized to find In[...]:=" (interactive) (setq search-last-regexp "^[ \t]*In\\[[0-9]+\\]:=\\s *") (setq unread-command-char search-reverse-char) (isearch-backward-regexp)) (defun math-identify-cell (pt &optional procmark out-ok) "Finds cell around POS. Optional second arg PROCMARK (normally the process-mark) will bound the search if the boundary otherwise would be a blank line (or the beginning of the buffer) and POS >= PROCMARK. Optional 3rd arg OUT-OK will allow acceptance of Out cells as well as In cells. If it is not t and not nil, it accepts all the way to the next In[...] cell. Returns a list of the buffer position of the beginning and end of the cell." (save-excursion (goto-char pt) ;; back up at most one blank line looking for input (end-of-line) (re-search-backward (cond ((eq out-ok t) "\\(^[ \t]*In\\[[0-9]+\\]:= ?\\)\\|\\(^\\s *\n\\)\\|\\(^[ \t]*Out\\[[0-9]+\\]\\(//[^=]*\\)?= ?\\)") ((eq out-ok nil) "\\(^[ \t]*In\\[[0-9]+\\]:= ?\\)\\|\\(^\\s *\n\\)") (t "\\(^[ \t]*In\\[[0-9]+\\]:= ?\\)\\|\\(^[ \t]*Out\\[[0-9]+\\]\\(//[^=]*\\)?= ?\\)")) nil 1) (goto-char (cond ((match-end 1)) ((and out-ok (match-end 3))) ((and procmark (>= pt procmark)) (max procmark (or (match-end 2) (point-min) ))) ((match-end 2)) ((point-min)))) (let ((bpt (point)) ept ) (if (re-search-forward (cond ((memq out-ok '(t nil)) "^\\s *$\\|^[ \t]*Out\\[[0-9]+\\][^=\n]*=\\|^[ \t]*In\\[[0-9]+\\]:=") (t "^[ \t]*In\\[[0-9]+\\]:=") ); end of cond nil 1) ;; If it matches, we have found the beginning of a line ;; following the cell. Back up one character. ;; If it doesn't match we are at eob and end of cell. (goto-char (max (- (match-beginning 0) 1) bpt))) (setq ept (point)) (list bpt ept)))) (defun kill-math-cell (pt) "Kills the cell around POINT. If it is an In[...] cell, the following Out[...] cell is also killed." (interactive "*d") (let ((region-info (math-identify-cell pt nil 1))) (goto-char (car region-info)) (forward-line 0) (kill-region (point) (car (cdr region-info))) (re-search-forward "\\(^[ \t]*In\\[[0-9]+\\]:= ?\\)\\|\\(^[ \t]*Out\\[[0-9]+\\]\\(//[^=]*\\)?= ?\\)" nil t))) (defun get-math-completion (prefix) "Returns string to insert to complete a Mathematica symbol Designed to be called as in (insert (get-math-completion word))" (let ((cbuf (current-buffer))) (unwind-protect (progn (set-buffer " Mathwork") (goto-char (point-min)) (let (alist) (while (looking-at "\\S +") (setq alist (cons (list (buffer-substring (match-beginning 0) (match-end 0))) alist)) (forward-line 1)) (set-buffer cbuf) (let ((t-c-result (and alist (try-completion prefix alist)))) ; try-completion barfs on a nil alist, so we help it out (cond ((eq t-c-result t) (message "%s is complete" prefix) "") ((eq t-c-result nil) (message "No match found") "") ((not (string= prefix t-c-result)) (substring t-c-result (length prefix))) (t (with-output-to-temp-buffer "*Help*" (display-completion-list (all-completions prefix alist)) (print-help-return-message)) ""))))) (set-buffer cbuf); unwind-protect exit ))) (defun kill-9-process () "Kills the process in the current buffer as in kill -9." (interactive) (kill-process (get-buffer-process (current-buffer)))) (defun metered-process-send-string (process string) "The same semantics as process-send-string, except the string is broken into small enough chunks to not mess up emacs." (let ((p 0) (len (length string))) (while (< p len) (process-send-string process (substring string p (setq p (min len (+ p 80)))))))) (defun skip-over-white-lines () ;; it might be possible to do this with ;; (re-search-forward "\\(^\\s *\n\\)*") ;; but this works. (while (and (not (eobp)) (looking-at "^\\s *$") ; blank line (zerop (forward-line))))) (defun find-math-error () "Searches for the last \"syntax error in\" message; goes to indicated line in the indicated file. It uses the symbol Mathematica-search-path rather than going to all the work to discover the real real search path." (interactive) (let (filename linenumber raw-filename (math-search-path Mathematica-search-path)) (save-excursion (re-search-backward "Syntax::sntx:") (forward-line 0) (if (not (looking-at ".*(line \\([0-9]+\\) of \"\\([^\"\n \t]+\\)\")$")) (error "Cannot parse error line")) (setq raw-filename (buffer-substring (match-beginning 2) (match-end 2))) (setq linenumber (string-to-int (buffer-substring (match-beginning 1) (match-end 1))))) (while (not filename) (setq filename (expand-file-name raw-filename (car math-search-path))) (if (not (file-readable-p filename)) (progn (setq filename nil) (setq math-search-path (cdr math-search-path)) (if (null math-search-path) (error "File %s not found" raw-filename))))) (find-file-other-window filename) (goto-line linenumber))) (defun set-math-process-buffer (buffer) "Sets the buffer in/to which to evaluate/copy Mathematica code. (You only need to use this function if you want a buffer other than *math*.)" (interactive "bMathematica buffer: ") (make-local-variable 'math-process-buffer) ;; The following trick will use the buffer itself if ;; it is defined. That way if the user eventually ;; changes the name, say by writing it out, this local ;; math-process-buffer will still point to the right place. ;; But if the buffer does not yet exist, it will still work. (setq math-process-buffer (or (get-buffer buffer) buffer))) (run-hooks 'math-mode-load-hook)

**QuadricSurface and ConicSection**

**z scale for ListPlot3D**

**QuadricSurface and ConicSection**

**z scale for ListPlot3D**