Variables de Marco de Datos

Una variable de marco de datos contiene datos tabulares en una estructura similar a una hoja de cálculo: las filas son entradas y las columnas son variables, cada una de las cuales puede contener valores de cadena, numéricos, booleanos o de archivo. Los marcos de datos no se llenan a través de las respuestas de los participantes. Subes un archivo .csv para cargar datos en ellos, y el experimento lee desde ellos en tiempo de ejecución utilizando el sistema de eventos.

Los marcos de datos son la herramienta estándar en Labvanced para gestionar entradas estructuradas: listas de estímulos, cronogramas de contrabalanceo, asignaciones de archivo a imagen y cualquier otro escenario donde necesites alimentar filas de datos preparados en tu experimento un ensayo a la vez.

Cuándo usar un marco de datos

Utiliza un marco de datos cada vez que tu experimento necesite cargar datos estructurados pre-preparados en lugar de recopilar valores de los participantes.

• Tienes una lista de palabras de estímulo, oraciones, imágenes o archivos de audio que deberían aparecer ensayo por ensayo.
• Necesitas contrabalancear condiciones entre participantes.
• Quieres mezclar el orden de los ensayos al comienzo de un experimento y luego leer entradas secuencialmente.
• Estás cargando mensajes de OpenAI, mensajes personalizados u otros datos de cadena desde un archivo preparado.

Configuración de un marco de datos

Crear un marco de datos lleva tres pasos: preparar tu CSV, crear la variable y importar el archivo.

Formateando tu CSV

Cada columna en tu CSV se convierte en una variable (columna) en el marco de datos. Cada fila es una entrada. Si tu primera fila contiene nombres de columna, habilita Use first row as header en la importación.

Para estímulos basados en archivos (imágenes, audio), coloca los nombres de archivo en la columna correspondiente. Luego puedes usar Map strings to files en la importación para vincular esos nombres a archivos subidos en tu estudio.

Creando la variable de marco de datos

1. Abre tu estudio y ve a la pestaña Variables en el panel izquierdo, o abre la pestaña del panel Variables en el editor de tareas.
2. Haz clic en + New Variable y establece Data Type en Data Frame.
3. Haz clic en Save. Se abre el Diálogo de Marco de Datos.

Subiendo tu CSV

En el Diálogo de Marco de Datos, haz clic en Upload 2D CSV Data. Se abre un selector de archivos. Después de seleccionar tu archivo, aparece el diálogo de Opciones de Importación.

Haz clic en Ok para importar. El marco de datos se llena con el contenido de tu CSV.

Editando un marco de datos

Una vez que se crea un marco de datos, puedes extenderlo con nuevas columnas, editar directamente los valores de celdas individuales o reemplazar todo el contenido con una nueva carga de CSV.

Agregando columnas

Para agregar una nueva columna después de la importación inicial, haz clic en Add variable / Column en la parte superior del Diálogo de Marco de Datos. Esto agrega una columna vacía que puedes nombrar y configurar. Si la nueva columna contiene nombres de archivo, haz clic en Map all strings to files en el diálogo después para vincularlos a los archivos subidos en tu estudio.

Editando valores de celdas

Para editar directamente los valores de celdas individuales, habilita la casilla de verificación Edit Values en el Diálogo de Marco de Datos. Las celdas se vuelven editables en su lugar. Desactiva la casilla de verificación para volver a la vista de solo lectura.

Usando marcos de datos en el sistema de eventos

Los marcos de datos se leen y escriben a través del sistema de eventos. Dos acciones en la categoría Operaciones de Marco de Datos manejan esto.

Leer de / Escribir en Acción de Marco de Datos

Usa esta acción para leer una fila o columna del marco de datos en una variable de arreglo, o para escribir valores de vuelta.

Parámetros clave:

El patrón más común es: mantener una variable de contador numérico que se incrementa en cada ensayo, usarla como variable de índice y leer la fila correspondiente en un arreglo. Cada elemento del arreglo se mapea luego a una columna de esa fila.

Mezclar Entradas de Marco de Datos Acción

Usa esta acción para aleatorizar el orden de las filas o columnas en el marco de datos. Ejecútala una vez al comienzo del experimento (activada por un evento de inicio de sesión) antes de que comiencen los ensayos.

Parámetros:

Un flujo de trabajo común: lista de estímulos por ensayo

Una configuración típica para leer una fila de estímulos por ensayo:

1. Sube un CSV con una fila por ensayo y columnas para cada atributo de estímulo (por ejemplo, word, condition, correct_response).
2. Crea una variable numérica trial_index con un valor inicial de 0 y Reset at Trial Start desactivada.
3. Al iniciar el experimento, agrega una acción Shuffle Data Frame Entries en tu marco de datos (por filas).
4. Al comienzo de cada ensayo, agrega una acción Read from / Write to Data Frame: leer por fila, Variable de índice = trial_index, Variable de salida = una variable de arreglo (por ejemplo, current_trial_data).
5. Después de leer, incrementa trial_index por 1 usando una acción aritmética Set / Record Variable.
6. Usa los elementos de la variable de arreglo para establecer propiedades de objeto o controlar la lógica de eventos para ese ensayo.

Lectura adicional