Adaptable tool for visualization, open data, and reproducible research
- Aaron, Blackwell -
Inspiration & frustration Frustration is also a way of knowledge: -
- There is also some stuff I don't like about these tools, -
- or that I would like to mix and match for my own needs. -
- What if inspiration for the future -
- is in the past and the -
- crossborder? -
- Bifurcation -
- (recombination?) -
Paper
- Adaptable tool for visualization, open data, and reproducible research -
- - -- Aaron, Blackwell -
- - -- Inspiration & frustration Frustration is also a way of knowledge: -
-- There is also some stuff I don't like about these tools, -
-- or that I would like to mix and match for my own needs. -
- - -- Publicaciones abiertas para la web: primeras pruebas -
- - - -- Paper -
- - - -Grafoscopio no hubiera sido posible sin la ayuda de muchas personas vinculadas a diversos lugares comunitarios e institucionales. Acá un listado de algunos de esos lugares y personas.
-Algunas personas han ayudado mucho con su escucha y apoyo, al margen de cualquier vinculación intitucional y/o comunitaria. Entre ellas: Andrés Calderón, Hilda Cárdenas y Yanneth Gil.
-Grafoscopio es una herramienta amoldable y flexible para la creación de documentos interactivos estructurados por capas. Sirve para alentar nuevas prácticas escriturales y de visualización de datos que puede ser usado en distintas contextos: escritura académica, educación, narrativa y periodismo de datos, ciencia e investigación abiertas, ciudadanas y/o de garage, narrativa transmedia, activismo y muchos más.
-Veámos en detalle algunos elementos de la definición:
-Sobre los documentos digimos que eran:
-Documentos estructurados y por capas: Grafoscopio permite centrarse en las palabras y su estructura, sin distracciones de otra índole. Delega la apariencia a plantillas y programas externos permitiendo concentrarse sólo en la escritura y la estructura de la misma. Para la estructura usa un árbol que permite expresar secciones del texto: títulos, subtítulos, capítulos, ideas, e incluso partes invisibles, que ayudan a redactar aquello que sí se va a ver. Para las palabras usa un sencillo y popular lenguaje de etiquetas (llamado markdown), que se aprende en pocos minutos y permite expresar elementos del texto: enfasis (cursiva), enfasis fuerte (negrilla), listas de items, numeraciones, tablas y referencias a gráficos.
Documentos Interactivos: Grafoscopio permite que los documentos, además de palabras y estructura, incluyan automatismos que extraen y calculan información externa y crean gráficos dinámicos a partir de ella, entre muchos otros usos. Incluso todo el árbol de un documento es programable, con lo cual podemos usar un mismo árbol (o algunas de sus partes) para crear diversos documentos a partir de distintos recorridos, lo cual brinda posibilidades extensas: galerías de imágenes web a partir de todas las figuras referenciadas, exportar el documento como un micrositio web, tomar partes de Internet e integrarlas a un documento, etc. Te invitamos a aprender a programar, pero incluso si es una decisión que no has tomado, podrás emplear esas funcionalidades a partir de los plugins y extensiones que la comunidad irá construyendo.
Sobre la herramienta digimos que era amoldable y flexible. Con esto nos referimos a que es fácil adaptar la herramienta a otros propósitos, contextos o intenciones. Esto definitivamente requiere de programación y de que entiendas el entorno de desarrollo de software integrado con grafoscopio, el paradigma de programación orientada a objetos y el lenguaje Smalltalk. Si ya sabes programar, este otro paradigma
-será beneficioso para mejorar la forma en que abordas problemas, incluso si no lo usas en tu entorno cotidiano; y si aún no sabes, te invitamos a una experiencia con un nivel de flexibilidad, interactividad que no hemos encontrado en otros lados. Tomará tiempo y paciencia, pero será progresivo, muy gratificante, empoderador y definitivamente menos demorado que los abordajes usuales. Esto va en contra de los libros tipo "aprenda a programar en 21 días" y como decía "alguien en Internet", no se encuentran libros similares sobre tocar un instrumento musical, pintar o aprender a cocinar. La maestría cuesta, sin embargo, grafoscopio está allí para ayudarte. Puedes pasar de los documentos estructurados, sin ninguna programación a los documentos interactivos, y de estos a la programación y modificación del entorno completo. Notarás que gracias a la uniformidad del entorno, las transiciones serán fluidas, en caso de que quieras emprenderlas, y dispondremos de espacios comunitarios (digitales y análogos), así como momentos de encuentro para facilitar el aprendizaje. La subsección "Aprende" de la página web referenciada al final, muestra algunos de esos espacios y momentos.
Ya sea que estés interesado en la escritura sin distracciones o en los documentos dinámicos e interactivos, grafoscopio será una herramienta que te permita explorar y expresar tus ideas de modos más fluidos.
+Grafoscopio es una herramienta amoldable y flexible para la creación de documentos interactivos con capas. Sirve para alentar nuevas prácticas escriturales y de visualización de datos que puede ser usado en distintas contextos: escritura académica, educación, narrativa y periodismo de datos, ciencia e investigación abiertas, ciudadanas y/o de garage, narrativa transmedia, activismo y muchos más.
Para mayor información sobre Grafoscopio visita:
-http://mutabit.com/grafoscopio/
-Empezar a usar grafoscopio será sencillo. Consistirá en 3 pasos: 1) descargar la versión para tu plataforma, 2) descomprímirlo y 3) ejecutarlo. Si lo quieres llevar contigo o copiarlo a otras máquinas, bastará con que copies la carpeta donde está el programa y listo! Incluso lo podrás ejecutar desde memorias USB.
-grafoscopio.sh
que aparece en la raíz de la carpeta descomprimidaADVERTENCIA: Si está ejecutando una distribución de Gnu/Linux de 64 bits, debe instalar el soporte para ejecución de las librerías de 32 bits. Usualmente se llaman ia-32.
-grafoscopio.bat
que aparece en la raíz de la carpeta descomprimidaAún no se ha empaquedado esta versión.
-Otra manera de instalar grafoscopio consiste en descargar primero la versión de Moose para nuestra plataforma y luego usar el gestor de paquetes que viene integrado para instalarlo desde el código fuente. Esencialmente se ejecutan 4 pasos:
-Descargar la variante de la máquina virtual de Pharo para Windows, Gnu/Linux, ó OSX y descomprimirla.
Descargar la imagen de Moose.
Lanzar la máquina virtual en la plataforma y abrir la imagen de Moose.
Abrir un playground y ejecutar lo siguiente:
Gofer new
- smalltalkhubUser: 'SvenVanCaekenberghe' project: 'STON';
- package: 'STON-Core';
- load.
-
-Gofer new
- smalltalkhubUser: 'Offray' project: 'Grafoscopio';
- package: 'Grafoscopio';
- load.
-Y listo!
-Para ejecutar grafoscopio, dentro de un workspace ejecutamos:
-GrafoscopioBrowser startDockingBar
-Si estás en esta parte del documento imaginamos que ya tienes instalado grafoscopio, e incluso que estás mirando este documento desde grafoscopio mismo. Si ese no es el caso, te recomendamos que:
-Vayas a http://mutabit.com/grafoscopio, instales grafoscopio, lo ejecutes y abras este documento haciendo click en el menú superior en Ayuda > Manual en grafoscopio
.
Maximices la ventana del documento y hagas click en la fecha que aparece junto a "Manual de Grafoscopio" y luego selecciones "Panorámica Rápida". Deberías estar viendo este documento.
Ahora que estamos seguros de que estás leyendo este documento dentro de grafoscopio, te mostraremos cómo funciona la interface:
-A la izquierda tienes un arbol. Este jerarquiza la información en ramas o nodos. Un nodo consta de dos partes básicas:
-A su vez un nodo puede agrupar a otros nodos. En ese caso el nodo que agrupa a los otros se conoce como padre y los agrupados en éste, se conocen como hijos. Por ejemplo, el nodo padre de este nodo se titula "Manual de Grafoscopio" y un nodo hijo de este nodo se titula "Modificar y exportar subárboles" Cuando un nodo tiene hijos, se reconoce porque tiene una flecha a su izquierda que apunta hacia la derecha. Si haces click en esa flecha, apunta hacia abajo y muestra los hijos del nodo. Si haces click en una flecha hacia abajo, apunta de nuevo a la derecha y oculta los hijos del nodo.
-Lo anterior nos permite navegar el árbol de dos maneras: haciendo click en cada nodo, de acuerdo a lo explicado, o haciendo click en cualquier parte del árbol y desplazándonos luego con las flechas del teclado.
Para continuar, despliega el árbol de la izquierda y ubícate en el hijo de este nodo titulado "Modificar y exportar subárboles"
-¡Bien! estás en el primer ejercicio. Si leíste el nodo "Panorámica rápida" ya sabes la terminología básica de nodos padres e hijos y también como navegar en un árbol o lo intuías por tu cuenta (la prueba es que estás acá).
-Este primer ejercicio consistirá en aprender a modificar un documento, lo cual permitirá luego crear los propios.
-Cuando estás dentro de una parte de un árbol, como acá, el nodo en el que estás parado, sus hijos, los hijos de esos hijos y así suscesivamente constituyen lo que se llama un "subárbol".
-Por ejemplo, si en el tutorial digital te paras en el nodo titulado "Subárbol de ejemplo" se despliega lo siguiente:
-- Primera sección
-- Segunda sección
- - Primera subsección
- - Segunda subsección
- - Primera sub-subsección
- - Tercera subsección
-Como verás, podemos anidar información, con lo cual vamos dando cuenta de la estructura que queremos que tenga un documento. Si quieres, dale una mirada a los contenidos del subárbol, pero no olvides luego volver acá, pues aquí continua la explicación.
-Bien, digamos que quieres ver cómo luce este subárbol como documento en HTML. Para exportar cualquier subárbol como HTML haces lo siguiente:
-Una mención especial merece el nodo "Configuración". notarás que tiene una etiqueta con el nombre "config" y si haces click en él verás unos datos de la forma:
-Eso es lo que se llama un diccionario en Smalltalk, y es una manera de representar atributos y sus valores. En este nodo, estamos diciendo dónde queremos que se guarde el documento que se produciría al exportar este subárbol. La mejor forma de verlo en acción es
-Acá te contamos del lugar que espera llenar grafoscopio. De las fuentes de inspiración y los espacios que no creíamos que estuviesen ocupados.
+http://mutabit.com/grafoscopio/
El iceberg es una buena metáfora para la creación en general: el resultado es sólo muestra la superfie de un proceso que es más profundo. En la mayoría de los proyectos, cada informe, texto, visualización, esta sustentado por un conjunto de soportes, autores, archivos e insumos, que quedan por fuera del documento que apeló a los mismos para existir. Dichas conexiones quedan ocultas bajo el texto o la gráfica; las tablas tienen los datos, pero no las consultas que los extrayeron, los insumos se deperdigan en la cabeza de los autores, las carpetas y referencias bibliográficas cuyo uso más allá de las citas. Se puede tener un texto suscinto y de fácil lectura o extenso y detallado, pero siempre se oculta las complejidades que lo construyen, lo cual dificulta la participación y transparencia posterior, propia de los procesos más horizontales e incluyentes.
Por ello se requieren metáforas escriturales distintas, que integren las distintas capas y niveles de profundidad propios de proyectos complejos como estos. En esencia se trata de pasar de las metáforas Lo Que Ves Es Lo Que Obtienes o WYSIWYG (por las siglas en inglés para What You See Is What You Get) a metáforas de "escritura tipo iceberg" donde Lo Que Ves Es Sólo La Superficie De Lo Que Tienes.
Grafosocpio intenta explorar un buen balance entre detalle y legibilidad usando las estructuras arbóreas en la que la escritura se organiza por capas. Las capas más profundas, contienen los detalles que permite la estructuración y escritura de documentos como los antes mencionados, y en las capas más externas, está aquello que el lector va a ubicar e incluso la organización para diferentes tipos de lectores, permitiendo a la vez dar cuenta, en un documento integrado, de recursos externos, anidamientos y relaciones internas y otros elementos constitutivos pero distintos del texto.
Este tipo alternativo de formas escriturales ayudaría en varios sentidos:
@@ -167,35 +34,89 @@Ideas similares:
Ideas diferentes:
A diferencia de Leo, TeXmacs, IPython es más fácil de entender, extender y modificar. Fuí usuario de Leo varios años y sólo hasta los últimos años empecé a cambiarlo de modo superficial. Los cambios que hice a TeXmacs también se vieron limitados. Traduje buena parte del manual a español e hice algunos scripts para personalizar los menús de la interface. TeXmacs está hecho con Scheme y C++, lenguajes bien diferentes y si bien con el primero se podría hacer parte de los cambios, si se quiere llegar a profundidad, se requiere del segundo. IPython consta de múltiples capas que requieren conceptos y tecnologías diversos para hacer que funcione: json, python, html, zeroMQ, programación de cliente y servidor, lenguajes de scripting, programación imperativa y objetual.
-Todas las anteriores herramientas están hechas desde la tradición Unix de tener archivos estáticos, que se editan desde editores externos, con idiosincracias distintas, lo cual genera una curva de aprendizaje más inclinada.
-En cambio, creé el primer alfa grafoscopio en un par de meses, incluido el aprendizaje de los rudimentos de Smalltalk (lenguaje y entorno). Esto es un mérito del entorno altamente interactivo, uniforme e integrado y la sintaxis sencilla y poderosa que provee Pharo/Smalltalk, frente al paradigma más convencional y extendido, pero menos fluido, de los sistemas operativos.
A diferencia de Leo, TeXmacs, IPython es más fácil de entender, extender y modificar. Fuí usuario de Leo varios años y sólo hasta los últimos años empecé a cambiarlo de modo superficial. IPython consta de múltiples capas que requieren conceptos y tecnologías diversos para hacer que funcione: json, python, html, zeromq, programación de cliente y servidor, lenguajes de scripting, programación imperativa y objetual. TeXmacs está hecho con Scheme y C++, lenguajes bien diferentes y si bien con el primero se podría hacer parte de los cambios, si se quiere llegar a profundidad, se requiere del segundo.
+Todas las anteriores herramientas están hechas desde la tradición Unix de tener archivos estáticos, que se editan desde editores externos, con idiosincracias distintas, lo cual genera una curva de aprendizaje más inclinada.
En cambio, creé el primer alfa grafoscopio tardó en un par de meses, incluido el aprendizaje de los rudimentos de Smalltalk (lenguaje y entorno). Esto es un mérito del entorno altamente interactivo, uniforme e integrado y la sintaxis sencilla y poderosa que provee Pharo/Smalltalk, frente al paradigma más convencional y extendido, pero menos fluido, de los sistemas operativos.
Dicho todo esto, grafoscopio es una herramienta que espera tener su propio lugar. No pretende desplazar a ninguna y, como dije, le debe mucha inspiración a las que he mencionado. Guardo profundo respeto y admiración por los autores, las comunidades detrás de tales herramientas y por las herramientas mismas y si bien las uso menos en la medida que grafoscopio madura, siguen teniendo un lugar en mi baticinturón (y mi corazón :-P).
-Empezar a usar grafoscopio será sencillo. Consistirá en 3 pasos: 1) descargar la versión para tu plataforma, 2) descomprímirlo y 3) ejecutarlo. Si lo quieres llevar contigo o copiarlo a otras máquinas, bastará con que copies la carpeta donde está el programa y listo! Incluso lo podrás ejecutar desde memorias USB.
+grafoscopio.sh
que aparece en la raíz de la carpeta descomprimidaADVERTENCIA: Si está ejecutando una distribución de Gnu/Linux de 64 bits, debe instalar el soporte para ejecución de las librerías de 32 bit. Usualmente se llaman ia-32.
+grafoscopio.bat
que aparece en la raíz de la carpeta descomprimidaAún no se ha empaquedado esta versión.
+Otra manera de instalar grafoscopio consiste en descargar primero la versión de Moose para nuestra plataforma y luego usar el gestor de paquetes que viene integrado para instalar desde allí Pharo. Esencialmente se ejecutan 4 pasos:
+Descargar la variante de la máquina virtual de Pharo para Windows, Gnu/Linux, ó OSX y descomprimirla.
Descargar la imagen de Moose.
Lanzar la máquina virtual en la plataforma y abrir la imagen de Moose.
Abrir un playground y ejecutar lo siguiente:
Gofer new
+ smalltalkhubUser: 'SvenVanCaekenberghe' project: 'STON';
+ package: 'STON-Core';
+ load.
+
+Gofer new
+ smalltalkhubUser: 'Offray' project: 'Grafoscopio';
+ package: 'Grafoscopio';
+ load.
+Y listo!
+Para ejecutar grafoscopio, dentro de un workspace ejecutamos:
+GrafoscopioBrowser open
+Estamos preparando unos documentos interactivos para la exploración de grafoscopio. Puedes descargarlos, abrirlos en grafoscopio y mirar cómo funcionan. Acá están los enlaces:
¿Cuándo un artefacto (digital o no) está listo para liberarse al público? Me parece que la respuesta tiene que ver con la experiencia de uso. El principal criterio de dicha experiencia es que no debe ser confusa. Esto no quiere decir que esté completa o que sea totalmente amigable o "intuitiva" (ese término siempre me ha parecido engañoso y me pregunto: ¿de acuerdo a la intuición de quién?). Se trata sobre todo de que las personas sepan qué esperar del artefacto.
-Muchas de estas espectativas se pueden informar con la documentación. Algo que haga claro cuáles son las ofertas, limitaciones y potencialdades del artefacto. Este mapa de ruta intenta aclarar esos aspectos.
-He organizado el mapa de ruta en forma de un tablero Kanban, con tres lugares "Por Hacer", "Hecho" y "Haciendo", que junto con el repositorio de código fuente (en Monticello) y de documentación (en fossil) del proyecto muestran cómo se van implementando las diferentes características que se integran en la experiencia de usuario. Puedes revisar cada una de las tres secciones del Kanban para ver en qué estamos trabajando, que hemos resuelto y qué tenemos proyectado hacia el futuro.
-Para la primera versión pública grafoscopio debería desde soportar una primera experiencia tres pasos: descargue, descomprima y explore. Esto quiere decir que debe tener una barra de tareas con acceso a las funcionalidades más empleadas y la documentación en distintos formatos.
-De ahí en adelante se puede establecer un modelo de rolling release, similar al de algunas distribuciones del sistema operativo Gnu/Linux, como Arch, en el que acceder a nuevas caracteríscas nuevas del sistema, simplemente sea actualizarse a la última versión (para esto actualmente existe una opción de menú integrada a la interfaz gráfica, que hace esto).
-Ese es el mapa, por lo pronto, pero se reciben sugerencias de futuras rutas.
-Muchas de estas espectativas se pueden informar con la documentación. Algo que haga claro cuáles son las ofertasm limitaciones y potencialdades del artefacto. Este mapa de ruta intenta aclarar esos aspectos.
+Para la primera versión pública grafoscopio debería soportar una primera experiencia tres pasos: descargue, descomprima y explore. Esto quiere decir que debe tener:
+De ahí en adelante se puede establecer un modelo de rolling release, similar al de algunas distribuciones del sistema operativo Gnu/Linux, como Arch, en el que acceder a nuevas caracteríscas nuevas del sistema, simplemente sea actualizarse a la última versión (para esto actualmente existe una opción de menú integrada a la interface gráfica, que hace esto).
Las características futuras previstas son:
.
-adas no se ven dentro del árbol.
-ste es un listado de los asistentes a los talleres sobre grafoscopio:
-Asistentes:
-Memorias:
-Asistentes:
-Memorias: - Enlaces: - http://etherpad.wikimedia.org/p/grafoscopio-5
-Ese es el mapa, por lo pronto, pero se reciben sugerencias de futuras rutas.