R for Reproducible Scientific Analysis: Guía del instructor

Tiempo

Dedicar unos 30 minutos antes del comienzo de cada taller y otros 15 minutos al comienzo de cada sesión para resolver dificultades técnicas como WiFi e instalación cosas (incluso si le pediste a los estudiantes que instalen programas con anticipación, y reservar más tiempo si no lo hiciste).

Planificación de la lección

La lección contiene mucho más material del que puede ser enseñado en un día. Los instructores deberán elegir un subgrupo apropiado de episodios a usar para un curso estándar de un día de duración.

Algunos lineamientos sugeridos del material a utilizar son:

(sugerido por @liz-is)

(sugerido por @naupaka)

Medio día de curso podría consistir en (sugerido por @karawoo):

Configurando git en RStudio

Pueden haber dificultades relacionando git a RStudio dependiendo del sistema operativo y de su versión. Para asegurarse que Git está correctamente instalado y configurado, los alumnos deberán ir a la ventana Opciones de la aplicación RStudio.

Para evitar que los alumnos tengan que re-ingresar su password cada vez que hacen un push a GitHub, éste comando (que puede ser corrido desde un prompt de bash) hará que solo tengan que ingresar su password una única vez:

$ git config --global credential.helper 'cache --timeout=10000000'

Obteniendo datos

La forma más simple de obtener los datos usados en esta lección durante un taller es hacer que los asistentes ejecuten lo siguiente:

git remote add data https://github.com/resbaz/r-novice-gapminder-files
git pull data master

Si Git no está siendo enseñado como parte del taller, entonces los datos crudos pueden ser descargados desde gapminder-FiveYearData y gapminder-FiveYearData-Wide.

Los asistentes pueden usar el diálogo Archivo - Guardar como... de su navegador para guardar el archivo.

En general

Asegurarse de enfatizar las buenas prácticas: escribir el código en scripts y hacer que esté bajo control de versiones. Alentar a los estudiantes a crear archivos de scripts para resolver los desafíos.

Si estás trabajando en un ambiente remoto (en “la nube”), puedes pedirles que suban los datos de gapminder luego de la segunda lección.

Asegurate de enfatizar que, a fin de cuentas, las matrices son vectores y que las data frames son listas: esto explicará mucho del comportamiento esotérico encontrado en las operaciones básicas.

El reciclado de vectores y funciones probablemente se explican mejor usando diagramas en una pizarra.

Es recomendado mirar y hacer los ejemplos de una página de ayuda de R: los archivos de ayuda pueden ser intimidantes al principio, pero saber cómo leerlos es tremendamente útil.

Mostrar las CRAN task views, verlas con uno de los temas.

Hay mucho contenido: muévete rápidamente por las primeras lecciones. Éstas son extensas mayormente con el propósito de aprender por ósmosis: de forma que su recuerdo se dispare cuando se encuentren luego con un problema o comportamiento esotérico.

Lecciones clave en las cuales dedicar tiempo:

No se preocupes por no equivocarte o conocer el material de pies a cabeza. Usa los errores como momentos de aprendizaje: la habilidad más importante que puedes enseñar es cómo eliminar errores (debug) y recuperarse de errores inesperados.