From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
To: Thierry Banel <tbanelwebmin@free.fr>
Cc: emacs-orgmode@gnu.org
Subject: Re: make orgtbl-ascii-plot easier to install
Date: Tue, 26 Aug 2014 10:29:59 +0200 [thread overview]
Message-ID: <87tx4zhcvs.fsf@nicolasgoaziou.fr> (raw)
In-Reply-To: <53E7F088.8010401@free.fr> (Thierry Banel's message of "Mon, 11 Aug 2014 00:22:00 +0200")
Hello,
Thierry Banel <tbanelwebmin@free.fr> writes:
> Sorry for the late answer, I was on the road.
> The patch is attached hereafter.
Thank you for the patch. Some comments follow.
> From 5fddaba2208c2cb4ce3b6bc24d0d10571124fb39 Mon Sep 17 00:00:00 2001
> From: Thierry Banel <tbanelwebmin@free.fr>
> Date: Mon, 11 Aug 2014 00:00:21 +0200
> Subject: [PATCH] * org-table.el: add ascii plotting in tables,
> (orgtbl-ascii-plot): top-level function
> (orgtbl-ascii-draw), (orgtbl-uc-draw-grid),
> (orgtbl-uc-draw-cont): helper functions which go in table
If they are helper functions, I suggest to use "--" in their name, e.g.,
`orgbtl--ascii-draw'.
> +(defun orgtbl-ascii-draw (value min max &optional width characters)
> + "Draws an ascii bar in a table.
> +VALUE is a the value to plot, the width of the bar to draw.
> +A value equal to MIN will be displayed as empty (zero width bar).
> +A value equal to MAX will draw a bar filling all the WIDTH.
> +WIDTH is the expected width in characters of the column.
> +CHARACTERS is a string of characters that will compose the bar,
This is a minor issue, but a "string of characters" sounds strange:
aren't all strings constituted of characters? Maybe you really want
a list of characters.
> +with shades of grey from pure white to pure black.
> +It defaults to a 10 characters string of regular ascii characters.
> +"
Spurious newline at the end of the docstring.
> + (unless characters (setq characters " .:;c!lhVHW"))
> + (unless width (setq width 12))
I suggest let-binding variables instead:
(let ((characters (or characters " .:;c!lhvHW"))
(width (or width 12))))
> + (if (stringp value)
> + (setq value (string-to-number value)))
Prefer `and' or `when' over one-armed `if'. Also, this may be dangerous
since `string-to-number' can return funny values. Why wouldn't you
simply forbid strings and limit VALUE to integers.
> + (setq value (* (/ (- (+ value 0.0) min) (- max min)) width))
(let ((value ...)))
> + (cond
> + ((< value 0) "too small")
> + ((> value width) "too large")
> + (t
> + (let ((len (1- (length characters))))
> + (concat
> + (make-string (floor value) (elt characters len))
> + (string (elt characters
> + (floor (* (- value (floor value)) len)))))))))
> +
> +(defun orgtbl-uc-draw-grid (value min max &optional width)
> + "Draws an ascii bar in a table.
> +It is a variant of orgtbl-ascii-draw with Unicode block characters,
> +for a smooth display.
> +Bars appear as grids (to the extend the font allows).
> +"
Spurious newline. I wouldn't put the last sentence on its own line, too.
Also, isn't it "extent"?
> +(defun orgtbl-uc-draw-cont (value min max &optional width)
> + "Draws an ascii bar in a table.
> +It is a variant of orgtbl-ascii-draw with Unicode block characters,
> +for a smooth display.
> +Bars are solid (to the extend the font allows).
> +"
Ditto.
> + (orgtbl-ascii-draw value min max width " \u258F\u258E\u258D\u258C\u258B\u258A\u2589\u2588"))
> +
> +;;;###autoload
> +(defun orgtbl-ascii-plot (&optional ask)
> + "Draws an ascii bars plot in a column, out of values found in another column.
> +A numeric prefix may be given to override the default 12 characters wide plot.
> +"
You must refer explicitly to ASK in your docstring. In particular, you
may want to detail the distinction between '(4) and 4.
Spurious newline too.
> + (interactive "P")
> + (let ((col (org-table-current-column))
> + (min 1e999)
`most-positive-fixnum'
> + (max -1e999)
`most-negative-fixnum'
> + (length 12)
> + (table (org-table-to-lisp)))
> + (cond ((consp ask)
> + (setq length
> + (or
> + (read-string "Length of column [12] " nil nil 12)
> + 12)))
> + ((numberp ask)
> + (setq length ask)))
(let ((length (cond ((consp ask)
(read-number "Length of column [12] " nil nil 12))
((numberp ask) ask)
(t 12)))))
> + (mapc
Small nitpick: I suggest to use `dolist' instead of `mapc' (no funcall
overhead).
> + (lambda (x)
> + (when (consp x)
> + (setq x (nth (1- col) x))
> + (when (string-match
> + "^[-+]?\\([0-9]*[.]\\)?[0-9]*\\([eE][+-]?[0-9]+\\)?$"
> + x)
Would `org-table-number-regexp' make sense here instead of the
hard-coded regexp?
> + (setq x (string-to-number x))
> + (if (> min x) (setq min x))
> + (if (< max x) (setq max x)))))
(when (> min x) ...)
(when (< max x))
> + (or (memq 'hline table) table)) ;; skip table header if any
This check is not sufficient in the following cases:
|-----------|
| no header |
|-----------|
and
|----------|
| header |
|----------|
| contents |
IOW, you need to eliminate the leading 'hline, if any, and skip until
the next 'hline if there is one and if there is something after it.
Regards,
--
Nicolas Goaziou
next prev parent reply other threads:[~2014-08-26 8:29 UTC|newest]
Thread overview: 31+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-07-13 16:02 make orgtbl-ascii-plot easier to install Thierry Banel
2014-07-28 14:40 ` Bastien
2014-08-10 22:22 ` Thierry Banel
2014-08-26 8:29 ` Nicolas Goaziou [this message]
2014-08-26 19:52 ` Thierry Banel
2014-08-26 20:27 ` Nicolas Goaziou
2014-08-26 21:42 ` Thierry Banel
2014-08-26 22:09 ` Nicolas Goaziou
2014-08-26 22:21 ` Thierry Banel
2014-08-27 21:35 ` Thierry Banel
2014-08-27 23:28 ` Nicolas Goaziou
2014-08-28 20:46 ` Thierry Banel
2014-08-29 9:54 ` Nicolas Goaziou
2014-08-29 17:20 ` Thierry Banel
2014-09-02 21:53 ` [PATCH] " Thierry Banel
2014-09-03 18:22 ` Nicolas Goaziou
2014-09-03 20:10 ` A key-binding for plotting Thierry Banel
2014-09-06 14:35 ` [PATCH] remap orgtbl-ascii-plot to C-c # Thierry Banel
2014-09-08 16:30 ` Nicolas Goaziou
2014-09-13 17:06 ` key-binding for all plotting styles Thierry Banel
2014-10-07 14:15 ` Nicolas Goaziou
2014-10-07 21:40 ` Thierry Banel
2014-10-11 17:46 ` [PATCH] " Thierry Banel
2014-10-12 9:28 ` Nicolas Goaziou
2014-10-12 10:00 ` Thierry Banel
2014-10-12 14:05 ` Thierry Banel
2014-10-13 16:24 ` Nicolas Goaziou
2014-10-13 21:16 ` Thierry Banel
2014-10-14 20:48 ` Thierry Banel
2014-10-14 21:08 ` Nicolas Goaziou
2014-10-14 21:26 ` Thierry Banel
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87tx4zhcvs.fsf@nicolasgoaziou.fr \
--to=mail@nicolasgoaziou.fr \
--cc=emacs-orgmode@gnu.org \
--cc=tbanelwebmin@free.fr \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).