Jul 06 2010

Org-mode: propiedades y columnas

Tag: basicoverdrive @ 3:49 am

En este articulo nos adentraremos un poco mas en org-mode, basicamente en que se pueden aplicar propiedades a distintas areas, que luego veremos que utilidad tiene. Para entender este post es necesario entender como trabajar con tablas en org-mode y como crear listas en org-mode (relacionadas o no con las tareas o TODO).

Es posible asignar propiedades a columnas o elementos de una lista, estas propiedades tendran un valor (por eso son pares) por ejemplo:

* Coleccion de CD
** Clasica
*** Variacion Goldberg
:PROPERTIES:
:Titulo: Variacion Goldberg
:Compositor: J.S. Bach
:Artista: Glen Gould
:Publicante: Deutsche Grammophon
:NDisks: 1
:END:

Se puede definir una lista de posibles valores para una propiedad en particular, para ello se le debe anadir el sufijo _ALL al nombre de la propiedad. Esto tendra una consecuencia especial a nivel de herencia, que si se marca una entrada, se aplicara para el arbol entero. Ademas definiendo una lista de posibles valores permitira evitar errores a la hora de escribir, por ejemplo:

* Coleccion de CD
:PROPERTIES:
:NDisks_ALL: 1 2 3 4
:Publisher_ALL: «Deutsche Grammophon» Philips EMI
:END:

Para definir posibles valores para propiedades de forma global podemos hacerlo de la siguiente manera (o mediante la variable global org-global-properties):

#+PROPERTY: NDisks_ALL 1 2 3 4

Los siguientes keybindings son usados para trabajar con propiedades:

  • M-TAB : Pulsado despues de : inicial en una linea, autocompleta claves.
  • C-c C-x p : Asigna un valor a una propiedad. Si fuese necesario la propiedad drawer sera creada.
  • M-x org-insert-property-drawer : Inserta una propiedad drawer en la entrada actual.
  • C-c C-c : Ejecuta comandos de la propiedad
  • C-c C-c s : Da un valor para la propiedad actual. Ambos, tanto la propiedad como el valor pueden ser autocompletados.
  • S-<– : Cambia la propiedad al valor anterior.
  • S—> : Cambia la propiedad al siguiente valor.
  • C-c C-c d : Elimina una propiedad de la entrada actual.
  • C-c C-c D : Elimina de forma global una propiedad de todas las entradas del fichero actual.
  • C-c C-c c : Computa la propiedad actual.

Propiedades especiales

Las propiedades especiales permiten acceder de forma alternativa a estas funcionalidades, por ejemplo:

TODO : Tarea TODO de la entrada.
TAGS : TAGS definidos directamente en una linea de cabecera.
ALLTAGS : Todos los TAGS, incluidos los heredados.
CATEGORY : La categoria de la entrada.
PRIORITY : La prioridad de la entrada.
DEADLINE : El limite de tiempo.
SCHEDULED : El tiempo o timestamp de esta entrada.
CLOSED : Cuando fue realmente cerrada esta entrada.
TIMESTAMP : La primera fecha de una entrada.
TIMESTAMP_IA : La primera fecha de inactividad de una entrada.
CLOCKSUM : La suma de los intervalos de tiempo de un subarbol. org-clock-sum debe ser lanzado la primera vez para computar dichos valores.
ITEM : El contenido de una entrada.

Busqueda de propiedades

Al crear estos arboles y listas especiales con una seleccion basada en propiedades podemos usar los siguientes keystrokes:

  • C-c \ ó C-c / m : Crea un arbol donde guardar todas las entradas que coincidan. Con el prefijo C-u ignora las lineas de cabecera que no son TODO.
  • C-c a m : Crea una lista global de propiedades/tags que coinciden con los ficheros de la agenda.
  • C-c a M : Crea una lista global de tags que coinciden con los ficheros de la agenda, pero fuerza solo a entradas TODO y todos sus subelementos (ver variable org-tags-match-list-sublevels).
  • C-c / p : Crea un arbol basado en el valor de la propiedad. Primero muestra el nombre de la propiedad y luego su valor.

Herencia de propiedades

Como bien dijimos anteriormente, si un padre tiene una propiedad determinada, su hijo la puede heredar. Por defecto esto esta deshabilitado, debido a que puede retardar bastante las busquedas, asi que si se quiere habilitar tendremos que configurar la variable org-use-property-inheritance. Ademas org tiene algunas propiedades hardcodeadas por defecto a nivel hereditario, que son:

COLUMNS : Define el formato de la vista de la columna.
CATEGORY : Para la vista de la agenda, la propiedad se aplica al subarbol entero.
ARCHIVE : Para archivacion, dicha propiedad debe definir la localizacion del archivo para el subarbol entero.
LOGGING : Para logueo, debe definir las opciones del logueo para cada entrada del subarbol.

Vista de columnas

Mediante la vista de columnas podremos tener un modo comodo para ver y editar propiedades de una columna, donde cada nodo sera convertido en una fila tabulable. Por lo que podemos usar:
  • TAB : para desplazarnos entre columnas de esta fila de propiedades.
  • S-TAB S-TAB : para ver el contenido o compactarla de nuevo.

Podemos definir el formato de una columna para un solo fichero de la siguiente forma:

#+COLUMNS: %25ITEM %TAGS %PRIORITY %TODO

Para especificar que dicho formato solo se aplique a un arbol especifico deberiamos hacer algo asi:

** Alto del nodo para vista de columnas
:PROPERTIES:
:COLUMNS: %25ITEM %TAGS %PRIORITY %TODO
:END:

Los atributos que podemos conceder a las columnas se definen con la siguiente sintaxis:

%[ancho]propiedad[(titulo)][{tipo_sumario}]

Todos los elementos son opcionales a excepcion del simbolo % y el nombre de la propiedad:

ancho un valor entero que indicara el ancho de la columna en caracteres.
propiedad la propiedad a ser editada en esta columna.
(titulo) La cabecera del texto para la columna.
{tipo_sumario} Si se especifica, el valor de las columnas para el padre seran computadas para los hijos:
{+} Suma los miembros en esta columna
{+;%.lf} Como ‘+’ pero usando formato para long float
{$} Divisas
{:} Suma los tiempos HH:MM:SS
{X} Estado del checkbox, [X] si todas los hijos son [X]
{X/} Estado del checkbox, [n/m]
{X%} Estado del checkbox [n%]
{min} El numero mas pequeno de la columna
{max} El mayor numero de la columna
{mean} Significado artimetico de los valores
{:min} El valor de tiempo mas pequeno de la columna
{:max} El mayor valor de tiempo de la columna
{:mean} Significado aritmetico de los valores de tiempo.
{@min} Edad minima (en dias/horas/minutos/segundos)
{@max} Edad maxima (en dias/horas/minutos/segundos)
{@mean} Significado artimento de los valores (en dias/horas/minutos/segundos)

El siguiente ejemplo muestra que cada elemento tendra 25 caracteres de ancho como linea de cabecera, los siguientes especificardores tendran las columnas Dueno, Estado y Aprobados:

:COLUMNS: %25ITEM %9Aprobados(Aprobados?){X} %Duenos %11Estado %10Tiempo_Estimado{:} %CLOCKSUM
:Duenos_ALL: Juan Pedro Luis Alberto Javi
:Estado_ALL: «En progreso» «No comenzado todavia» «Finalizado» «»
:Aprobados_ALL: «[ ]» «[X]»

Podremos acceder a la vista de columnas usando los siguientes keystrokes:

Para activar/desactivar:

  • C-c C-x C-c : Activa la vista de columna. Si el cursor se encuentra antes de la primera linea de cabecera del fichero, se aplicara entonces para todo el fichero. El formato sera tomado de la variable org-columns-default-format.
  • r ó g: Recrea la vista de columna.
  • q : Sale de la vista de columna.

Para editar valores:

  • <izq> : Se desplaza hacia el campo de la izquierda en la vista de columnas.
  • <der> : Se desplaza hacia el campo de la derecha en la vista de columnas.
  • <arriba> : Se desplaza hacia el campo de la izquierd en la vista de columnas.
  • <abajo> : Se desplaza hacia el campo de la izquierda en la vista de columnas.
  • S-<– ó p : Modifica el valor al anterior para dicho campo.
  • S—> ó n : Modifica el valor al siguiente para dicho campo.
  • 1..9,0 : Selecciona el Nth valor, 0 seleccionara el decimo valor.
  • e : Edita la propiedad actual.
  • C-c C-c : Hace toggle de un checkbox.
  • v : Ve el valor completo de la propiedad actual (util cuando la columna es mas pequena que el valor).
  • a : Edita la lista de valores permitidos para dicha propiedad. Si el valor no existe, lo anadira a la lista.

Para modificar la estructura de la tabla:

  • < : Estrecha la columna.
  • > : Amplia la columna.
  • S-M—> : Inserta una nueva columna a la derecha de la columna actual.
  • S-M-<– : Elimina la columna actual.

La vista de columnas es tan solo un overlay sobre un buffer, por lo que este no puede ser exportado o impreso directamente, para ello debemos usar bloques dinamicos de vistas de columnas, tal que asi:

* La vista de columna
#+BEGIN: columnview :hlines 1 :id «label»
#+END:

El bloque dinamico tiene los siguientes parametros:

:id Es el identificador, que puede ser local, global, file:ruta-al-fichero o directamente el ID.
:hlines Cuando es t, inserta una linea horizontal despues de cada linea. Cuando es un numero N, inserta una linea horizontal antes de cada linea de cabecera con un nivel inferior o igual a N.
:vlines Cuando es t, fuerza los grupos de columnas para tener lineas verticales.
:maxlevel Cuando tiene un valor N, no captura las entradas por debajo del nivel N.
:skip-empty-rows Cuando es t, ignora las filas donde no hay indicada una linea en blanco para un ITEM.

Los siguientes comandos permiten insertar o actualizar un bloque dinamico:

  • C-c C-x i : Inserta un bloque dinamico capturando una vista de columna.
  • C-c C-c ó C-c C-x C-u : Actualiza el bloque dinamico actual. El cursor debe estar al principio de la linea de dicho bloque #+BEGIN.
  • C-u C-c C-x C-u : Actualiza todos los bloques dinamicos. Util para bloques con tablas de reloj.

Es posible anadir formulas a la columna de una vista de una tabla en caso de querer hacer plotting sobre la tabla, por lo que incluir #+TBBLFM: despues de la tabla, recalculara la tabla automaticamente despues de una actualizacion.

Para mas informacion sobre la captura y proceso de valores de propiedades en una tabla es interesante ver el script org-collector.el, que provee una API para coleccionar propiedades de una entrada para un ambito concreto.


Jul 03 2010

Org-mode : Graficas / trazas (plot)

Tag: basicoverdrive @ 3:21 am

En el articulo anterior referente a spreadsheet u hojas de calculo, explicamos como es posible realizar hojas de calculo mediante org-mode de GNU/emacs. Como bien muchos saben, estas las hojas de calculo son datos tabulados en los que se pueden incluir referencias y demas, por lo que este software generalmente incluye lo que se llama plotting o traza de estos datos, o lo que es lo mismo realizar graficas haciendo uso de estos datos. GNU/emacs no es para menos, y tambien permite realizar lo mismo. He preferido separarlo en dos articulos (aunque este segundo me ha quedado algo corto), ya que en muchos casos no estamos para nada interesados en esta funcionalidad, pero si creo que es un aditivo a la funcionalidad anterior y esta estrechamente relacionada.

Plot

Se puede producir graficos en 2D y 3D mediante gnuplot, lo cual requiere de tener gnuplot y gnuplot-mode instalado. Se debe agregar a la primera linea de la tabla algo tal que asi (por ejemplo):

#+PLOT: title:»foobar» ind:1 deps:(3) type:2d with:histograms set:»yrang [0:]».

Existen otras funciones para plot tal que:

set: especifica cualquier opcion de gnuplot a ser modificada.
title: espeficia el titulo del ploteado.
ind: especifica que columna de la tabla usara el eje de las x.
deps: especifica las columnas a ser ploteadas.
type: especifica el tipo de ploteado, 2d, 3d o grid.
with: Especifica cada opcion a ser insertada (lines, points, boxes, impulses, etc).
file: especifica un fichero de salida para el ploteado.
labels: lista de etiquetas a ser usadas para las deps.
line: especifica una linea entera a ser insertada en el script de gnuplot.
map: Cuando dibuja en 3D o tipo, activa los mapas para ir mas alla de 3d slope.
timefmt: Especifica el formato de timestams.
script: control total especificando un fichero de script. Especificado por $datafile.

Los resultados son excepcionales, podeis probarlos, podeis encontrar mas informacion dedicada al tema en: http://cars9.uchicago.edu/~ravel/software/gnuplot-mode.html tambien podeis encontrar informacion interesante sobre gnuplot en su web oficial.


Jul 03 2010

Org-mode : spreadsheet (hojas de calculo)

Tag: basicoverdrive @ 3:01 am

Y aqui estamos con un nuevo articulo sobre org-mode, como no, org-mode permite la creacion y uso de hojas de calculo (en ingles spreadsheet). Parece increible como un software que a simple vista parece tan simple, pueda llegar a tener tanta potencia, todo esto no seria posible sin el magnifico grupo de desarrolladores de org-mode y en general a la comunidad tan activa de GNU/emacs, sin mas dilacion comenzamos explicando el uso de referencias.

Antes de comenzar, debe conocer un minimo el uso de tablas en org-mode, ya que las hojas de calculo se emplean mediante dicho uso, por lo que es necesario leer el articulo sobre Org-mode: tablas para poder aplicar luego hojas de calculo sobre el.

Referencias

Se puede referenciar un campo para computarlo con otros. Se puede referenciar dado su nombre, sus coordenadas absolutas o coordenadas relativas. Para saber las corrdenadas de un campo debemos presionar C-c ? que mostrar las coordenadas de dicho campo o bien C-c } que hara toggle de las coordenadas del grid.

La notacion que usa org es @fila$columna, si es relativa debemos anadir + o delante del numero. Tambien se puede especificar ‘I‘ para referirse a la primera linea, ‘II‘ a la segunda linea, ‘-I‘ a la (n)anterior linea o bien ‘III+2‘ para referirse al segundo dato de la tercera linea de la tabla. 0 se referira a la columna y fila actual.

Existen referencias especiales como ‘$LR5‘ que pueden ser usadas para referirse al 5o campo de la ultma fila de la tabla.

@2$3 -> 2a fila, 3a columna
C2 -> igual que la anterior columna
$5 -> 5a columna en la fila actual
E& -> igual que la anterior
@2 -> columna actual, 2a fila
@-1$-3 -> una fila mas arriba, tres columnas mas a la derecha
@-I$2 -> encima de la fila actual, columna 2

Rangos

$1..$3 -> Los primeros 3 campos de la fila actual
$P..$Q -> rango usando nombres de columnas P y Q
@2$1..@4$3 -> 6 campos entre estos dos campos, dando rutas relativas
A2..C4 -> 6 campos entre estos dos campos, dando rutas absolutas
@-1$-2..@-1 -> 3 numeros de la columna a la derecha, 2 arriba de la fila actual.

Referencias con nombre

Se puede asignar un nombre a una referencia mediante la variable org-table-formula-constants, o localmente mediante el fichero de configuracion:

#+CONSTANTS: c=299792458. pi=3.14 eps=2.4e-6

Es posible usar referencias remotas mediante:

remote(NAME-OR-ID,REF)

Donde nombre es el nombre de la tabla dado por #+TBLNAME: NAME o su ID. REF es la direccion absoluta o rango de referencias valido en la tabla.

Las formulas pueden ser usadas como expresiones algebraicas mediante el paquete calc de emacs (importante saber que usa convencion no estandar donde / tiene menos precedencia que *) mediante la funcion calc-eval se puede realizar esta evaluacion.

Mediante org-calc-default-modes se usara el modo standard de calc (precision 12, unidades angulares graduales, fracciones y los modos simbolicos deshabilitados).

p20 -> cambia la precision interna a 20 digitos
n3 s3 e4 f4 -> normal, cientifica, ingeniero o formato fijo
D R -> gradianes o radiales (angulo)
F S -> fraccion y simbolicos
N -> interpreta todos los campos como numeros, y usa 0 para los campos que no tengan numeros.
T -> fuerza la intepretacion del texto
E -> mantiene campos vacios en rangos

Ademas se puede usar printf como especificador de formato para reformatear el resultado final:

$1+$2 : suma el primero y el segundo campo
$1+$2;%.2f : suma los dos primeros campos usando 2 decimales
exp($2)+exp($1) : funciones matematicas
$0;%.1f : reformatea la celda actual a un decimal
($3-32)*5/9 : Conversion de grados Farenheit a Celsius
$c/$1/$cm : Conversion de Hz a cm
tan($1);Dp3s1 : computa en grados, precision 3, mostrando SCI 1
sin($1);Dp3%.le : usa el especificador printf para mostrar
vmean($2..$7) : computa un rango de columnas, usando un vector de funciones
vmean($2..$7);EN : igual, pero usa los campos vacios como 0
taylor($3,x=7,2) : serie de taylor de $3, en x=7, segundo grado.

Tambien se pueden contener expresiones logicas tales como:

if($1<20,teen,string(«»)) : teen, si la edad de $1 es menor que 20, en cualquier otro caso vacio.

Si lo que queremos es usar mas potencia podemos escribir formulas para la manipulacion de cadenas y el control de estrucutras tales como:

Intercambia los primeros dos caracteres de la columna 1:
‘(concat (substring $1 1 2) (substring $1 0 1) (substring $1 2))

Suma columnas 1 y 2, equivalnete a calc $1 y $2:
‘(+ $1 $2);N

Calcula la suma de las columnas 1 a 4:
‘(apply ‘+ ‘($1..$4));N

Para asignar una formula a un campo en particular, debe ir precedido por «:=«. Las formulas son guardadas en el formato especial con #+TBLFM: directamente debajo de la tabla. Ademas debemos usar el comando C-u C-c = si queremos insertar una nueva formula en el campo actual.

Es frecuente usar la misma formula para todos los campos de una columna, esto es posible mediante TAB, INTRO o C-c C-c para pasar guardar la formula en la columna usada. Una vez se sale a la siguiente fila tan solo debemos pulsar C-c =, e insertara la nueva formula en la columna actual, reemplazandola por el resultado, tambien es posible usar prefijos para aplicarlo en muchas celdas consecutivas de la columna actual.

Para editar y depurar (o debuggear) existe:

  • C-c = ó C-u C-c = : Edita una formula asociada con el campo/columna actual en el minibuffer.
  • C-u C-u C-c = : reinserta una formula activa en el campo actual. Ademas la ventaja de usar el minibuffer es que se puede emplear el comando C-c ?
  • C-c ? : Resalta el campo referenciado por la posicion del cursor en una formula.
  • C-c } : Muestra (toggle) los numeros de una fila y columna para una tabla, usando overlays. Con C-c C-c se puede formar la alineacion de la tabla cada vez.
  • C-c { : Hace toggle del debugger de formula.
  • C-c ‘ : Edita todas las formulas de la tabla actual en un buffer especial.
  • C-c C-c ó C-x C-s : Sale del editor de formulas
  • C-c C-q : Sale del editor de formula sin instalar los cambios.
  • C-c C-r : Hace toggle del editor de formulas para todas las referencias entre standard (B3, etc) e internas (@3$2, etc).
  • TAB : Hace impresion ‘bonita’, idnetando las formulas lisp, etc.
  • M-TAB : Completa los simbolos lisp.
  • S-up/down/left/right (tecla super + flechas) : Desplaza el punto de referencia.
  • M-S-up/down : Mueve la linea de test para formulas en columnas en el bufer de org.
  • M-up/down : Desplaza la ventana
  • C-c } : Muestra las coordenadas del grid de la tabla.

Cuando se evalua una forma que contiene errores se mostrara la cadena ‘#ERROR‘ para conocer que ocurrio en la substitucion de variables y calculos se puede emplear C-u C-u C-c = INTRO.

Para actualizar la tabla se pueden emplear los siguientes comandos:

  • C-c * : Recalcula la fila actual
  • C-u C-c * ó C-u C-c C-c : recalcula la tabla entera
  • C-u C-u C-c * ó C-u C-u C-c C-c : Itera la tabla para recalcularla hasta que los cambios ocurran.

Existen otras funciones avanzadas con tablas como:

  • C-# : rota la marca de calculos en la primera columa para los estados, ‘#‘, ‘*‘, ‘!‘, ‘$‘. Tambien se puede aplicar sobre regiones.

Las tablas especiales que comiencen con C-u C-c * solo afectara a filas marcadas por ‘#‘ y ‘*‘. Las marcas tienen los siguientes significados:

! : Define nombres para las columnas, por lo que es posible usar $nombre en lugar de $6.
^ : Define nombres para las filas, por lo que cualquier formula en la tabla que use $m1, tomara el valor de la misma.
_ : Define nombres en los campos de la fila inferior.
$ : Campos en esta fila pueden definir parametros para formulas. Por ej. si un campo de una fila contiene $, y dentro contiene max=50, las formulas en esta tabla se podran referir a $max usando como valor 50. Los parametros trabajaran como constantes.
# : Campos en esta fila seran automaticamente recalculados mediante TAB, INTRO o S-TAB o mediante C-u C-c * para recalcularlo de forma global.
* : Selecciona esta linea para recalcular globalmente con C-u C-c *, pero no de forma automatica (para evitar carga cuando se edita demasiado).
: Lineas desmarcadas estan excentas de calculos con C-u C-c *.
/ : No exporta esta linea.

Basicamente este es el uso de hojas de calculo con emacs, aunque en el siguiente articulo anadire una funcionalidad interesante que sabiendo esto puedan crearse graficos sobre dichos datos.