1 ;;; calc-mode.el --- calculator modes for Calc
3 ;; Copyright (C) 1990, 1991, 1992, 1993, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
6 ;; Author: David Gillespie <daveg@synaptics.com>
7 ;; Maintainer: Jay Belanger <jay.p.belanger@gmail.com>
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
28 ;; This file is autoloaded from calc-ext.el.
33 ;; Declare functions which are defined elsewhere.
34 (declare-function calc-embedded-save-original-modes
"calc-embed" ())
37 (defun calc-line-numbering (n)
40 (message (if (calc-change-mode 'calc-line-numbering n t t
)
41 "Displaying stack level numbers"
42 "Hiding stack level numbers"))))
44 (defun calc-line-breaking (n)
48 (and (> (setq n
(prefix-numeric-value n
)) 0)
51 (not calc-line-breaking
)))
52 (if (calc-change-mode 'calc-line-breaking n t
)
53 (if (integerp calc-line-breaking
)
54 (message "Breaking lines longer than %d characters" n
)
55 (message "Breaking long lines in Stack display"))
56 (message "Not breaking long lines in Stack display"))))
59 (defun calc-left-justify (n)
62 (and n
(setq n
(prefix-numeric-value n
)))
63 (calc-change-mode '(calc-display-just calc-display-origin
)
66 (message "Displaying stack entries indented by %d" n
)
67 (message "Displaying stack entries left-justified"))))
69 (defun calc-center-justify (n)
72 (and n
(setq n
(prefix-numeric-value n
)))
73 (calc-change-mode '(calc-display-just calc-display-origin
)
76 (message "Displaying stack entries centered on column %d" n
)
77 (message "Displaying stack entries centered in window"))))
79 (defun calc-right-justify (n)
82 (and n
(setq n
(prefix-numeric-value n
)))
83 (calc-change-mode '(calc-display-just calc-display-origin
)
86 (message "Displaying stack entries right-justified to column %d" n
)
87 (message "Displaying stack entries right-justified in window"))))
89 (defun calc-left-label (s)
90 (interactive "sLefthand label: ")
93 (setq s
(concat s
" ")))
94 (calc-change-mode 'calc-left-label s t
)))
96 (defun calc-right-label (s)
97 (interactive "sRighthand label: ")
100 (setq s
(concat " " s
)))
101 (calc-change-mode 'calc-right-label s t
)))
103 (defun calc-auto-why (n)
108 (setq n
(prefix-numeric-value n
))
109 (if (<= n
0) (setq n nil
)
110 (if (> n
1) (setq n t
))))
111 (setq n
(and (not (eq calc-auto-why t
)) (if calc-auto-why t
1))))
112 (calc-change-mode 'calc-auto-why n nil
)
114 (message "User must press `w' to explain unsimplified results"))
116 (message "Automatically doing `w' to explain unsimplified results"))
118 (message "Automatically doing `w' only for unusual messages")))))
120 (defun calc-group-digits (n)
125 (setq n
(prefix-numeric-value n
))
126 (cond ((or (> n
0) (< n -
1)))
130 (setq n calc-group-digits
))))
131 (setq n
(not calc-group-digits
)))
132 (calc-change-mode 'calc-group-digits n t
)
134 (message "Grouping is off"))
136 (message "Grouping every %d digits" (math-abs n
)))
138 (message "Grouping is on")))))
140 (defun calc-group-char (ch)
141 (interactive "cGrouping character: ")
144 (error "Control characters not allowed for grouping"))
147 (setq ch
(char-to-string ch
)))
148 (calc-change-mode 'calc-group-char ch calc-group-digits
)
149 (message "Digit grouping character is \"%s\"" ch
)))
151 (defun calc-point-char (ch)
152 (interactive "cCharacter to use as decimal point: ")
155 (error "Control characters not allowed as decimal point"))
156 (calc-change-mode 'calc-point-char
(char-to-string ch
) t
)
157 (message "Decimal point character is \"%c\"" ch
)))
159 (defun calc-normal-notation (n)
162 (calc-change-mode 'calc-float-format
163 (let* ((val (if n
(prefix-numeric-value n
) 0))
164 (mode (/ (+ val
5000) 10000)))
165 (if (or (< val -
5000) (> mode
3))
166 (error "Prefix out of range"))
167 (setq n
(list (aref [float sci eng fix
] mode
)
168 (- (%
(+ val
5000) 10000) 5000))))
171 (message "Displaying floating-point numbers normally")
174 "Displaying floating-point numbers with %d significant digits"
176 (message "Displaying floating-point numbers with (precision%d)"
179 (defun calc-fix-notation (n)
180 (interactive "NDigits after decimal point: ")
182 (calc-change-mode 'calc-float-format
183 (setq n
(list 'fix
(if n
(prefix-numeric-value n
) 0)))
185 (message "Displaying floats with %d digits after decimal"
186 (math-abs (nth 1 n
)))))
188 (defun calc-sci-notation (n)
191 (calc-change-mode 'calc-float-format
192 (setq n
(list 'sci
(if n
(prefix-numeric-value n
) 0)))
195 (message "Displaying floats in scientific notation")
197 (message "Displaying scientific notation with %d significant digits"
199 (message "Displaying scientific notation with (precision%d)"
202 (defun calc-eng-notation (n)
205 (calc-change-mode 'calc-float-format
206 (setq n
(list 'eng
(if n
(prefix-numeric-value n
) 0)))
209 (message "Displaying floats in engineering notation")
211 (message "Displaying engineering notation with %d significant digits"
213 (message "Displaying engineering notation with (precision%d)"
217 (defun calc-truncate-stack (n &optional rel
)
220 (let ((oldtop calc-stack-top
)
221 (newtop calc-stack-top
))
222 (calc-record-undo (list 'set
'saved-stack-top calc-stack-top
))
223 (let ((calc-stack-top 0)
224 (nn (prefix-numeric-value n
)))
229 (setq nn
(+ oldtop nn
))
231 (setq nn
(+ nn
(calc-stack-size)))
235 (if (> nn
(calc-stack-size))
238 (max 1 (calc-locate-cursor-element (point)))))
239 (if (= newtop oldtop
)
241 (calc-pop-stack 1 oldtop t
)
242 (calc-push-list '(top-of-stack) newtop
)
243 (if calc-line-numbering
245 (calc-record-undo (list 'set
'saved-stack-top
0))
246 (setq calc-stack-top newtop
))))
248 (defun calc-truncate-up (n)
250 (calc-truncate-stack n t
))
252 (defun calc-truncate-down (n)
254 (calc-truncate-stack (- n
) t
))
256 (defun calc-display-raw (arg)
259 (setq calc-display-raw
(if calc-display-raw nil
(if arg
0 t
)))
262 (message "Press d ' again to cancel \"raw\" display mode"))))
269 (defun calc-save-modes ()
273 (vals (mapcar (function (lambda (v) (symbol-value (car v
))))
274 calc-mode-var-list
)))
275 (unless calc-settings-file
276 (error "No `calc-settings-file' specified"))
277 (set-buffer (find-file-noselect (substitute-in-file-name
278 calc-settings-file
)))
279 (goto-char (point-min))
280 (if (and (search-forward ";;; Mode settings stored by Calc" nil t
)
284 (search-forward "\n;;; End of mode settings" nil t
)))
288 (delete-region pos
(point)))
289 (goto-char (point-max))
292 (insert ";;; Mode settings stored by Calc on " (current-time-string) "\n")
293 (let ((list calc-mode-var-list
))
295 (let* ((v (car (car list
)))
296 (def (nth 1 (car list
)))
300 (insert "(setq " (symbol-name v
) " ")
301 (if (and (or (listp val
)
303 (not (memq val
'(nil t
))))
305 (insert (prin1-to-string val
) ")\n"))))
306 (setq list
(cdr list
)
308 (run-hooks 'calc-mode-save-hook
)
309 (insert ";;; End of mode settings\n")
311 (if calc-embedded-info
312 (calc-embedded-save-original-modes)))))
314 (defun calc-settings-file-name (name &optional arg
)
316 (list (read-file-name (format "Settings file name (normally %s): "
317 (abbreviate-file-name calc-settings-file
)))
320 (setq arg
(if arg
(prefix-numeric-value arg
) 0))
321 (if (string-equal (file-name-nondirectory name
) "")
322 (message "Calc settings file is \"%s\"" calc-settings-file
)
323 (if (< (math-abs arg
) 2)
324 (let ((list calc-mode-var-list
))
326 (set (car (car list
)) (nth 1 (car list
)))
327 (setq list
(cdr list
)))))
328 (setq calc-settings-file name
)
331 (equal user-init-file calc-settings-file
)
335 (message "New file")))))
337 (defun math-get-modes-vec ()
343 (+ (if (<= (nth 1 calc-float-format
) 0)
344 (+ calc-internal-prec
(nth 1 calc-float-format
))
345 (nth 1 calc-float-format
))
346 (cdr (assq (car calc-float-format
)
347 '((float .
0) (sci .
10000)
348 (eng .
20000) (fix .
30000)))))
349 (cond ((eq calc-angle-mode
'rad
) 2)
350 ((eq calc-angle-mode
'hms
) 3)
352 (if calc-symbolic-mode
1 0)
353 (if calc-prefer-frac
1 0)
354 (if (eq calc-complex-mode
'polar
) 1 0)
355 (cond ((eq calc-matrix-mode
'scalar
) 0)
356 ((eq calc-matrix-mode
'matrix
) -
2)
357 ((eq calc-matrix-mode
'sqmatrix
) -
3)
360 (cond ((eq calc-simplify-mode
'none
) -
1)
361 ((eq calc-simplify-mode
'num
) 0)
362 ((eq calc-simplify-mode
'binary
) 2)
363 ((eq calc-simplify-mode
'alg
) 3)
364 ((eq calc-simplify-mode
'ext
) 4)
365 ((eq calc-simplify-mode
'units
) 5)
367 (cond ((eq calc-infinite-mode
1) 0)
368 (calc-infinite-mode 1)
371 (defun calc-get-modes (n)
374 (let ((modes (math-get-modes-vec)))
375 (calc-enter-result 0 "mode"
377 (if (and (>= (setq n
(prefix-numeric-value n
)) 1)
378 (< n
(length modes
)))
380 (error "Prefix out of range"))
383 (defun calc-shift-prefix (arg)
386 (setq calc-shift-prefix
(if arg
387 (> (prefix-numeric-value arg
) 0)
388 (not calc-shift-prefix
)))
390 (message (if calc-shift-prefix
391 "Prefix keys are now case-insensitive"
392 "Prefix keys must be unshifted (except V, Z)"))))
394 (defun calc-mode-record-mode (n)
397 (calc-change-mode 'calc-mode-save-mode
399 (cond ((not calc-embedded-info
)
400 (if (eq calc-mode-save-mode
'save
)
402 ((eq calc-mode-save-mode
'local
) 'edit
)
403 ((eq calc-mode-save-mode
'edit
) 'perm
)
404 ((eq calc-mode-save-mode
'perm
) 'global
)
405 ((eq calc-mode-save-mode
'global
) 'save
)
406 ((eq calc-mode-save-mode
'save
) nil
)
407 ((eq calc-mode-save-mode nil
) 'local
)))
408 ((= (setq n
(prefix-numeric-value n
)) 0) nil
)
415 (cond ((and (eq calc-mode-save-mode
'local
) calc-embedded-info
)
416 "Recording mode changes with [calc-mode: ...]")
417 ((eq calc-mode-save-mode
'edit
)
418 "Recording mode changes with [calc-edit-mode: ...]")
419 ((eq calc-mode-save-mode
'perm
)
420 "Recording mode changes with [calc-perm-mode: ...]")
421 ((eq calc-mode-save-mode
'global
)
422 "Recording mode changes with [calc-global-mode: ...]")
423 ((eq calc-mode-save-mode
'save
)
424 (format "Recording mode changes in \"%s\""
427 "Not recording mode changes permanently")))))
429 (defun calc-total-algebraic-mode (flag)
432 (if (eq calc-algebraic-mode
'total
)
433 (calc-algebraic-mode nil
)
434 (calc-change-mode '(calc-algebraic-mode calc-incomplete-algebraic-mode
)
436 (use-local-map calc-alg-map
)
438 "All keys begin algebraic entry; use Meta (ESC) for Calc keys"))))
440 (defun calc-algebraic-mode (flag)
444 (calc-change-mode '(calc-algebraic-mode
445 calc-incomplete-algebraic-mode
)
446 (list nil
(not calc-incomplete-algebraic-mode
)))
447 (calc-change-mode '(calc-algebraic-mode calc-incomplete-algebraic-mode
)
448 (list (not calc-algebraic-mode
) nil
)))
449 (use-local-map calc-mode-map
)
450 (message (if calc-algebraic-mode
451 "Numeric keys and ( and [ begin algebraic entry"
452 (if calc-incomplete-algebraic-mode
453 "Only ( and [ begin algebraic entry"
454 "No keys except ' and $ begin algebraic entry")))))
456 (defun calc-symbolic-mode (n)
460 (message (if (calc-change-mode 'calc-symbolic-mode n nil t
)
461 "Inexact computations like sqrt(2) are deferred"
462 "Numerical computations are always done immediately"))))
464 (defun calc-infinite-mode (n)
469 (calc-change-mode 'calc-infinite-mode
1)
470 (message "Computations like 1 / 0 produce \"inf\""))
471 (message (if (calc-change-mode 'calc-infinite-mode n nil t
)
472 "Computations like 1 / 0 produce \"uinf\""
473 "Computations like 1 / 0 are left unsimplified")))))
475 (defun calc-matrix-mode (arg)
478 (calc-change-mode 'calc-matrix-mode
479 (cond ((eq arg
0) 'scalar
)
480 ((< (prefix-numeric-value arg
) 1)
481 (and (< (prefix-numeric-value arg
) -
1) 'matrix
))
483 (if (consp arg
) 'sqmatrix
484 (prefix-numeric-value arg
)))
485 ((eq calc-matrix-mode
'matrix
) 'scalar
)
486 ((eq calc-matrix-mode
'scalar
) nil
)
488 (if (integerp calc-matrix-mode
)
489 (message "Variables are assumed to be %dx%d matrices"
490 calc-matrix-mode calc-matrix-mode
)
491 (message (if (eq calc-matrix-mode
'matrix
)
492 "Variables are assumed to be matrices"
493 (if (eq calc-matrix-mode
'sqmatrix
)
494 "Variables are assumed to be square matrices"
496 "Variables are assumed to be scalars (non-matrices)"
497 "Variables are not assumed to be matrix or scalar")))))))
499 (defun calc-set-simplify-mode (mode arg msg
)
500 (calc-change-mode 'calc-simplify-mode
502 (and (> (prefix-numeric-value arg
) 0)
504 (and (not (eq calc-simplify-mode mode
))
506 (message "%s" (if (eq calc-simplify-mode mode
)
508 "Default simplifications enabled")))
510 (defun calc-no-simplify-mode (arg)
513 (calc-set-simplify-mode 'none arg
514 "All default simplifications are disabled")))
516 (defun calc-num-simplify-mode (arg)
519 (calc-set-simplify-mode 'num arg
520 "Default simplifications apply only if arguments are numeric")))
522 (defun calc-default-simplify-mode (arg)
526 (calc-set-simplify-mode
527 nil nil
"Usual default simplifications are enabled")))
528 ((= arg
0) (calc-num-simplify-mode 1))
529 ((< arg
0) (calc-no-simplify-mode 1))
530 ((= arg
2) (calc-bin-simplify-mode 1))
531 ((= arg
3) (calc-alg-simplify-mode 1))
532 ((= arg
4) (calc-ext-simplify-mode 1))
533 ((= arg
5) (calc-units-simplify-mode 1))
534 (t (error "Prefix argument out of range"))))
536 (defun calc-bin-simplify-mode (arg)
539 (calc-set-simplify-mode 'binary arg
540 (format "Binary simplification occurs by default (word size=%d)"
543 (defun calc-alg-simplify-mode (arg)
546 (calc-set-simplify-mode 'alg arg
547 "Algebraic simplification occurs by default")))
549 (defun calc-ext-simplify-mode (arg)
552 (calc-set-simplify-mode 'ext arg
553 "Extended algebraic simplification occurs by default")))
555 (defun calc-units-simplify-mode (arg)
558 (calc-set-simplify-mode 'units arg
559 "Units simplification occurs by default")))
561 (defun calc-auto-recompute (arg)
564 (calc-change-mode 'calc-auto-recompute arg nil t
)
565 (calc-refresh-evaltos)
566 (message (if calc-auto-recompute
567 "Automatically recomputing `=>' forms when necessary"
568 "Not recomputing `=>' forms automatically"))))
570 (defun calc-working (n)
574 (calc-pop-push-record 0 "work"
575 (cond ((eq calc-display-working-message t
) 1)
576 (calc-display-working-message 2)
578 ((eq n
2) (calc-change-mode 'calc-display-working-message
'lots
))
579 ((eq n
0) (calc-change-mode 'calc-display-working-message nil
))
580 ((eq n
1) (calc-change-mode 'calc-display-working-message t
)))
581 (cond ((eq calc-display-working-message t
)
582 (message "\"Working...\" messages enabled"))
583 (calc-display-working-message
584 (message "Detailed \"Working...\" messages enabled"))
586 (message "\"Working...\" messages disabled")))))
588 (defun calc-always-load-extensions ()
591 (if (setq calc-always-load-extensions
(not calc-always-load-extensions
))
592 (message "Always loading extensions package")
593 (message "Loading extensions package on demand only"))))
596 (defun calc-matrix-left-justify ()
599 (calc-change-mode 'calc-matrix-just nil t
)
600 (message "Matrix elements will be left-justified in columns")))
602 (defun calc-matrix-center-justify ()
605 (calc-change-mode 'calc-matrix-just
'center t
)
606 (message "Matrix elements will be centered in columns")))
608 (defun calc-matrix-right-justify ()
611 (calc-change-mode 'calc-matrix-just
'right t
)
612 (message "Matrix elements will be right-justified in columns")))
614 (defun calc-full-vectors (n)
617 (message (if (calc-change-mode 'calc-full-vectors n t t
)
618 "Displaying long vectors in full"
619 "Displaying long vectors in [a, b, c, ..., z] notation"))))
621 (defun calc-full-trail-vectors (n)
624 (message (if (calc-change-mode 'calc-full-trail-vectors n nil t
)
625 "Recording long vectors in full"
626 "Recording long vectors in [a, b, c, ..., z] notation"))))
628 (defun calc-break-vectors (n)
631 (message (if (calc-change-mode 'calc-break-vectors n t t
)
632 "Displaying vector elements one-per-line"
633 "Displaying vector elements all on one line"))))
635 (defun calc-vector-commas ()
638 (if (calc-change-mode 'calc-vector-commas
(if calc-vector-commas nil
",") t
)
639 (message "Separating vector elements with \",\"")
640 (message "Separating vector elements with spaces"))))
642 (defun calc-vector-brackets ()
645 (if (calc-change-mode 'calc-vector-brackets
646 (if (equal calc-vector-brackets
"[]") nil
"[]") t
)
647 (message "Surrounding vectors with \"[]\"")
648 (message "Not surrounding vectors with brackets"))))
650 (defun calc-vector-braces ()
653 (if (calc-change-mode 'calc-vector-brackets
654 (if (equal calc-vector-brackets
"{}") nil
"{}") t
)
655 (message "Surrounding vectors with \"{}\"")
656 (message "Not surrounding vectors with brackets"))))
658 (defun calc-vector-parens ()
661 (if (calc-change-mode 'calc-vector-brackets
662 (if (equal calc-vector-brackets
"()") nil
"()") t
)
663 (message "Surrounding vectors with \"()\"")
664 (message "Not surrounding vectors with brackets"))))
666 (defun calc-matrix-brackets (arg)
667 (interactive "sCode letters (R, O, C): ")
669 (let ((code (append (and (string-match "[rR]" arg
) '(R))
670 (and (string-match "[oO]" arg
) '(O))
671 (and (string-match "[cC]" arg
) '(C))
672 (and (string-match "[pP]" arg
) '(P))))
673 (bad (string-match "[^rRoOcCpP ]" arg
)))
675 (error "Unrecognized character: %c" (aref arg bad
)))
676 (calc-change-mode 'calc-matrix-brackets code t
))))
680 ;; arch-tag: ecc70eea-c712-43f2-9085-4205e58d6ddf
681 ;;; calc-mode.el ends here