2010-06-11 19:02:42 -04:00
|
|
|
;;; ob-gnuplot.el --- org-babel functions for gnuplot evaluation
|
2009-07-16 20:35:22 -04:00
|
|
|
|
2012-03-17 11:31:04 -04:00
|
|
|
;; Copyright (C) 2009-2012 Free Software Foundation, Inc.
|
2009-07-16 20:35:22 -04:00
|
|
|
|
|
|
|
;; Author: Eric Schulte
|
|
|
|
;; Keywords: literate programming, reproducible research
|
|
|
|
;; Homepage: http://orgmode.org
|
|
|
|
|
2010-06-25 12:32:35 -04:00
|
|
|
;; This file is part of GNU Emacs.
|
2009-07-16 20:35:22 -04:00
|
|
|
|
2010-06-25 12:32:35 -04:00
|
|
|
;; GNU Emacs is free software: you can redistribute it and/or modify
|
2009-07-16 20:35:22 -04:00
|
|
|
;; it under the terms of the GNU General Public License as published by
|
2010-06-25 12:32:35 -04:00
|
|
|
;; the Free Software Foundation, either version 3 of the License, or
|
|
|
|
;; (at your option) any later version.
|
|
|
|
|
|
|
|
;; GNU Emacs is distributed in the hope that it will be useful,
|
2009-07-16 20:35:22 -04:00
|
|
|
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
;; GNU General Public License for more details.
|
2010-06-25 12:32:35 -04:00
|
|
|
|
2009-07-16 20:35:22 -04:00
|
|
|
;; You should have received a copy of the GNU General Public License
|
2010-06-25 12:32:35 -04:00
|
|
|
;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|
2009-07-16 20:35:22 -04:00
|
|
|
|
|
|
|
;;; Commentary:
|
|
|
|
|
|
|
|
;; Org-Babel support for evaluating gnuplot source code.
|
|
|
|
;;
|
|
|
|
;; This differs from most standard languages in that
|
|
|
|
;;
|
|
|
|
;; 1) we are generally only going to return results of type "file"
|
|
|
|
;;
|
|
|
|
;; 2) we are adding the "file" and "cmdline" header arguments
|
|
|
|
|
2009-08-16 12:48:08 -04:00
|
|
|
;;; Requirements:
|
|
|
|
|
|
|
|
;; - gnuplot :: http://www.gnuplot.info/
|
2012-03-19 16:38:12 -04:00
|
|
|
;;
|
2009-08-16 12:48:08 -04:00
|
|
|
;; - gnuplot-mode :: http://cars9.uchicago.edu/~ravel/software/gnuplot-mode.html
|
|
|
|
|
2009-07-16 20:35:22 -04:00
|
|
|
;;; Code:
|
2010-06-11 19:02:42 -04:00
|
|
|
(require 'ob)
|
2010-07-02 22:21:31 -04:00
|
|
|
(eval-when-compile (require 'cl))
|
|
|
|
|
|
|
|
(declare-function org-time-string-to-time "org" (s))
|
|
|
|
(declare-function org-combine-plists "org" (&rest plists))
|
|
|
|
(declare-function orgtbl-to-generic "org-table" (table params))
|
2010-07-04 11:24:08 -04:00
|
|
|
(declare-function gnuplot-mode "ext:gnuplot-mode" ())
|
|
|
|
(declare-function gnuplot-send-string-to-gnuplot "ext:gnuplot-mode" (str txt))
|
|
|
|
(declare-function gnuplot-send-buffer-to-gnuplot "ext:gnuplot-mode" ())
|
2009-07-16 20:35:22 -04:00
|
|
|
|
2009-07-20 15:33:53 -04:00
|
|
|
(defvar org-babel-default-header-args:gnuplot
|
|
|
|
'((:results . "file") (:exports . "results") (:session . nil))
|
2009-07-17 00:17:15 -04:00
|
|
|
"Default arguments to use when evaluating a gnuplot source block.")
|
|
|
|
|
|
|
|
(defvar org-babel-gnuplot-timestamp-fmt nil)
|
|
|
|
|
2009-07-19 17:30:40 -04:00
|
|
|
(defun org-babel-gnuplot-process-vars (params)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Extract variables from PARAMS and process the variables.
|
|
|
|
Dumps all vectors into files and returns an association list
|
2010-06-11 20:12:15 -04:00
|
|
|
of variable names and the related value to be used in the gnuplot
|
|
|
|
code."
|
2009-07-19 17:30:40 -04:00
|
|
|
(mapcar
|
|
|
|
(lambda (pair)
|
|
|
|
(cons
|
|
|
|
(car pair) ;; variable name
|
|
|
|
(if (listp (cdr pair)) ;; variable value
|
|
|
|
(org-babel-gnuplot-table-to-data
|
2010-09-20 19:38:31 -04:00
|
|
|
(cdr pair) (org-babel-temp-file "gnuplot-") params)
|
2009-07-19 17:30:40 -04:00
|
|
|
(cdr pair))))
|
2010-10-15 23:17:08 -04:00
|
|
|
(mapcar #'cdr (org-babel-get-header params :var))))
|
2009-07-19 17:30:40 -04:00
|
|
|
|
2010-10-15 23:35:45 -04:00
|
|
|
(defun org-babel-expand-body:gnuplot (body params)
|
2010-06-11 20:12:15 -04:00
|
|
|
"Expand BODY according to PARAMS, return the expanded body."
|
2009-09-14 22:22:34 -04:00
|
|
|
(save-window-excursion
|
|
|
|
(let* ((vars (org-babel-gnuplot-process-vars params))
|
|
|
|
(out-file (cdr (assoc :file params)))
|
|
|
|
(term (or (cdr (assoc :term params))
|
|
|
|
(when out-file (file-name-extension out-file))))
|
|
|
|
(cmdline (cdr (assoc :cmdline params)))
|
|
|
|
(title (plist-get params :title))
|
|
|
|
(lines (plist-get params :line))
|
|
|
|
(sets (plist-get params :set))
|
|
|
|
(x-labels (plist-get params :xlabels))
|
|
|
|
(y-labels (plist-get params :ylabels))
|
|
|
|
(timefmt (plist-get params :timefmt))
|
|
|
|
(time-ind (or (plist-get params :timeind)
|
2010-02-23 10:16:11 -05:00
|
|
|
(when timefmt 1)))
|
2012-08-09 10:13:18 -04:00
|
|
|
(add-to-body (lambda (text) (setq body (concat text "\n" body))))
|
2010-02-23 10:16:11 -05:00
|
|
|
output)
|
2012-08-09 10:13:18 -04:00
|
|
|
;; append header argument settings to body
|
|
|
|
(when title (funcall add-to-body (format "set title '%s'" title))) ;; title
|
|
|
|
(when lines (mapc (lambda (el) (funcall add-to-body el)) lines)) ;; line
|
|
|
|
(when sets
|
|
|
|
(mapc (lambda (el) (funcall add-to-body (format "set %s" el))) sets))
|
|
|
|
(when x-labels
|
|
|
|
(funcall add-to-body
|
|
|
|
(format "set xtics (%s)"
|
|
|
|
(mapconcat (lambda (pair)
|
|
|
|
(format "\"%s\" %d" (cdr pair) (car pair)))
|
|
|
|
x-labels ", "))))
|
|
|
|
(when y-labels
|
|
|
|
(funcall add-to-body
|
|
|
|
(format "set ytics (%s)"
|
|
|
|
(mapconcat (lambda (pair)
|
|
|
|
(format "\"%s\" %d" (cdr pair) (car pair)))
|
|
|
|
y-labels ", "))))
|
|
|
|
(when time-ind
|
|
|
|
(funcall add-to-body "set xdata time")
|
|
|
|
(funcall add-to-body (concat "set timefmt \""
|
|
|
|
(or timefmt
|
|
|
|
"%Y-%m-%d-%H:%M:%S") "\"")))
|
|
|
|
(when out-file (funcall add-to-body (format "set output \"%s\"" out-file)))
|
|
|
|
(when term (funcall add-to-body (format "set term %s" term)))
|
|
|
|
;; insert variables into code body: this should happen last
|
|
|
|
;; placing the variables at the *top* of the code in case their
|
|
|
|
;; values are used later
|
|
|
|
(funcall add-to-body (mapconcat #'identity
|
|
|
|
(org-babel-variable-assignments:gnuplot params)
|
|
|
|
"\n"))
|
|
|
|
;; replace any variable names preceded by '$' with the actual
|
|
|
|
;; value of the variable
|
|
|
|
(mapc (lambda (pair)
|
|
|
|
(setq body (replace-regexp-in-string
|
|
|
|
(format "\\$%s" (car pair)) (cdr pair) body)))
|
|
|
|
vars))
|
|
|
|
body))
|
2010-04-16 00:57:13 -04:00
|
|
|
|
|
|
|
(defun org-babel-execute:gnuplot (body params)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Execute a block of Gnuplot code.
|
|
|
|
This function is called by `org-babel-execute-src-block'."
|
2010-07-02 22:21:31 -04:00
|
|
|
(require 'gnuplot)
|
2010-04-16 00:57:13 -04:00
|
|
|
(let ((session (cdr (assoc :session params)))
|
|
|
|
(result-type (cdr (assoc :results params)))
|
2010-04-21 16:38:38 -04:00
|
|
|
(out-file (cdr (assoc :file params)))
|
2010-07-02 22:21:31 -04:00
|
|
|
(body (org-babel-expand-body:gnuplot body params))
|
|
|
|
output)
|
2010-04-16 00:57:13 -04:00
|
|
|
(save-window-excursion
|
|
|
|
;; evaluate the code body with gnuplot
|
|
|
|
(if (string= session "none")
|
2010-09-20 19:38:31 -04:00
|
|
|
(let ((script-file (org-babel-temp-file "gnuplot-script-")))
|
2010-04-16 00:57:13 -04:00
|
|
|
(with-temp-file script-file
|
|
|
|
(insert (concat body "\n")))
|
|
|
|
(message "gnuplot \"%s\"" script-file)
|
|
|
|
(setq output
|
2010-09-22 16:40:14 -04:00
|
|
|
(shell-command-to-string
|
|
|
|
(format
|
|
|
|
"gnuplot \"%s\""
|
2011-09-29 08:54:39 -04:00
|
|
|
(org-babel-process-file-name
|
|
|
|
script-file
|
|
|
|
(if (member system-type '(cygwin windows-nt ms-dos))
|
|
|
|
t nil)))))
|
2010-04-16 00:57:13 -04:00
|
|
|
(message output))
|
|
|
|
(with-temp-buffer
|
|
|
|
(insert (concat body "\n"))
|
|
|
|
(gnuplot-mode)
|
|
|
|
(gnuplot-send-buffer-to-gnuplot)))
|
|
|
|
(if (member "output" (split-string result-type))
|
|
|
|
output
|
2010-12-21 05:21:28 -05:00
|
|
|
nil)))) ;; signal that output has already been written to file
|
2009-07-16 20:35:22 -04:00
|
|
|
|
2009-07-19 17:01:47 -04:00
|
|
|
(defun org-babel-prep-session:gnuplot (session params)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Prepare SESSION according to the header arguments in PARAMS."
|
2009-07-19 17:01:47 -04:00
|
|
|
(let* ((session (org-babel-gnuplot-initiate-session session))
|
2010-10-21 07:00:00 -04:00
|
|
|
(var-lines (org-babel-variable-assignments:gnuplot params)))
|
2010-01-11 12:14:30 -05:00
|
|
|
(message "%S" session)
|
2009-07-19 18:40:28 -04:00
|
|
|
(org-babel-comint-in-buffer session
|
|
|
|
(mapc (lambda (var-line)
|
|
|
|
(insert var-line) (comint-send-input nil t)
|
|
|
|
(org-babel-comint-wait-for-output session)
|
2010-01-11 12:14:30 -05:00
|
|
|
(sit-for .1) (goto-char (point-max))) var-lines))
|
|
|
|
session))
|
|
|
|
|
|
|
|
(defun org-babel-load-session:gnuplot (session body params)
|
|
|
|
"Load BODY into SESSION."
|
|
|
|
(save-window-excursion
|
|
|
|
(let ((buffer (org-babel-prep-session:gnuplot session params)))
|
|
|
|
(with-current-buffer buffer
|
|
|
|
(goto-char (process-mark (get-buffer-process (current-buffer))))
|
|
|
|
(insert (org-babel-chomp body)))
|
|
|
|
buffer)))
|
2009-07-19 17:01:47 -04:00
|
|
|
|
2010-10-21 07:00:00 -04:00
|
|
|
(defun org-babel-variable-assignments:gnuplot (params)
|
2012-07-30 04:08:15 -04:00
|
|
|
"Return list of gnuplot statements assigning the block's variables."
|
2010-10-21 07:00:00 -04:00
|
|
|
(mapcar
|
|
|
|
(lambda (pair) (format "%s = \"%s\"" (car pair) (cdr pair)))
|
2010-10-27 00:48:04 -04:00
|
|
|
(org-babel-gnuplot-process-vars params)))
|
2010-10-21 07:00:00 -04:00
|
|
|
|
2010-07-02 22:21:31 -04:00
|
|
|
(defvar gnuplot-buffer)
|
2010-03-13 12:59:41 -05:00
|
|
|
(defun org-babel-gnuplot-initiate-session (&optional session params)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Initiate a gnuplot session.
|
|
|
|
If there is not a current inferior-process-buffer in SESSION
|
2010-06-11 20:12:15 -04:00
|
|
|
then create one. Return the initialized session. The current
|
2009-07-19 17:30:40 -04:00
|
|
|
`gnuplot-mode' doesn't provide support for multiple sessions."
|
2010-07-02 22:21:31 -04:00
|
|
|
(require 'gnuplot)
|
2009-07-19 17:01:47 -04:00
|
|
|
(unless (string= session "none")
|
2010-07-02 22:21:31 -04:00
|
|
|
(save-window-excursion
|
|
|
|
(gnuplot-send-string-to-gnuplot "" "line")
|
|
|
|
gnuplot-buffer)))
|
2009-07-16 20:35:22 -04:00
|
|
|
|
2009-07-17 00:17:15 -04:00
|
|
|
(defun org-babel-gnuplot-quote-timestamp-field (s)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Convert S from timestamp to Unix time and export to gnuplot."
|
2009-07-17 00:17:15 -04:00
|
|
|
(format-time-string org-babel-gnuplot-timestamp-fmt (org-time-string-to-time s)))
|
|
|
|
|
2010-07-02 22:21:31 -04:00
|
|
|
(defvar org-table-number-regexp)
|
|
|
|
(defvar org-ts-regexp3)
|
2009-07-17 00:17:15 -04:00
|
|
|
(defun org-babel-gnuplot-quote-tsv-field (s)
|
2010-07-13 19:20:08 -04:00
|
|
|
"Quote S for export to gnuplot."
|
2009-07-17 00:17:15 -04:00
|
|
|
(unless (stringp s)
|
|
|
|
(setq s (format "%s" s)))
|
|
|
|
(if (string-match org-table-number-regexp s) s
|
|
|
|
(if (string-match org-ts-regexp3 s)
|
|
|
|
(org-babel-gnuplot-quote-timestamp-field s)
|
|
|
|
(concat "\"" (mapconcat 'identity (split-string s "\"") "\"\"") "\""))))
|
|
|
|
|
|
|
|
(defun org-babel-gnuplot-table-to-data (table data-file params)
|
|
|
|
"Export TABLE to DATA-FILE in a format readable by gnuplot.
|
|
|
|
Pass PARAMS through to `orgtbl-to-generic' when exporting TABLE."
|
|
|
|
(with-temp-file data-file
|
|
|
|
(make-local-variable 'org-babel-gnuplot-timestamp-fmt)
|
|
|
|
(setq org-babel-gnuplot-timestamp-fmt (or
|
|
|
|
(plist-get params :timefmt)
|
|
|
|
"%Y-%m-%d-%H:%M:%S"))
|
|
|
|
(insert (orgtbl-to-generic
|
|
|
|
table
|
|
|
|
(org-combine-plists
|
|
|
|
'(:sep "\t" :fmt org-babel-gnuplot-quote-tsv-field)
|
|
|
|
params))))
|
|
|
|
data-file)
|
|
|
|
|
2010-06-11 19:02:42 -04:00
|
|
|
(provide 'ob-gnuplot)
|
2010-06-25 12:32:35 -04:00
|
|
|
|
2011-08-15 14:04:38 -04:00
|
|
|
|
2010-06-25 12:32:35 -04:00
|
|
|
|
2010-06-11 19:02:42 -04:00
|
|
|
;;; ob-gnuplot.el ends here
|