Acción de Establecer / Grabar Variable

La acción Set / Record Variable escribe un valor en una variable en el momento en que se activa el evento que la contiene. Se encuentra en la categoría Variable Actions del sistema de eventos, y es la acción más común en Labvanced: casi cada medida de comportamiento grabada y casi cada condición impulsada por variable en un estudio pasa por ella en algún momento.

Descripción General

Una vez que una variable existe, Set / Record Variable es cómo realmente obtiene un valor: un tiempo de reacción, una elección del participante, una puntuación acumulativa, un par de coordenadas de un movimiento del ratón. Sin ella, una variable se mantiene en su valor inicial durante todo el estudio.

Casos de Uso Comunes

Set / Record Variable aparece en casi cada categoría de estudio, desde tareas simples de pulsación de botones hasta grabaciones fisiológicas completas.

• Grabando una medida de comportamiento: guarda un tiempo de reacción, una puntuación de exactitud o una respuesta escrita en una variable para que aparezca en los datos exportados.
• Construyendo un contador: incrementa una variable en 1 cada vez que se activa un desencadenador, para contar ensayos completados, errores cometidos o clics de botón.
• Capturando valores específicos de desencadenadores: escribe valores que proporciona un desencadenador, como coordenadas X/Y del ratón o una posición de mirada, directamente en una variable.
• Impulsando lógica condicional: establece una variable que un Requirement Action posterior verifica para decidir qué rama del estudio se ejecuta a continuación.

Conocimientos Previos Requeridos

Antes de sumergirse en esta acción, se recomienda comprender las funciones básicas de creación de variables y sus propiedades, como se describe en estas páginas:

Creando Variables

Las diferentes formas de crear una variable en Labvanced, desde la pestaña Variables, el editor de tareas, un aviso de objeto, o el sistema de eventos.

Propiedades de Variable

Los ajustes que definen una variable: nombre, tipo de dato, escala y el conmutador de grabar variable.

Cómo Funciona

Para acceder a Set / Record Variable, abre el Sistema de Eventos en el Editor de Tareas y crea un nuevo evento. Bajo Add Action → Variable Actions, selecciona Set / Record Variable.

Aparece un cuadro de diálogo simple con dos partes, que se lee como una ecuación:

Esa es toda la acción: elige una variable, define su nuevo valor, listo. El diálogo también muestra una línea fija, "Las grabaciones se realizarán al final del ensayo": el valor de la variable se actualiza en el cliente inmediatamente cuando se ejecuta la acción, pero ese valor solo se envía al servidor y se graba al final del ensayo, no en cada cambio individual.

Un escenario práctico: construyendo un contador. No hay una variable de "contador" especial incorporada en Labvanced, cualquier variable puede actuar como tal. Crea una variable numérica con el nombre que se ajuste a tu estudio (por ejemplo trial_count o error_count), luego utiliza la opción Arithmetic del Menú de Selección de Valor para establecer el nuevo valor de esa variable a sí misma más uno, cada vez que se active el desencadenador relevante. Este es el mismo mecanismo detrás de los contadores de ensayos, contadores de errores y contadores de clics en las tareas de Labvanced, por lo que es importante entender cómo funciona dicha configuración para tener una idea de las capacidades detrás de esta acción.

En algunos casos, mientras construyes tu tarea, se te puede pedir un cuadro de diálogo preguntando si deseas que se creen eventos automáticamente para capturar ciertos tipos de datos, como el seguimiento ocular. Aceptar esto construye tanto el desencadenador como una acción Set / Record Variable para ti, ya configurada, la misma acción y diálogo descritos anteriormente.

Consejos para el Flujo de Trabajo

• Planifica tus variables antes de construir: antes de comenzar a construir, asegúrate de conocer todos los datos que necesitas capturar en tu estudio y tener una idea general de qué variables necesitarás crear para almacenar esos datos. Set / Record Variable es donde se ejecuta ese plan, así que decidirlo de antemano evita reestructurar eventos a mitad de la construcción.
• Reutiliza una acción similar en lugar de reconstruirla: si ya tienes una acción Set / Record Variable similar bajo el mismo desencadenador o en otra parte del estudio, usa Copy to Clipboard y pégala donde sea necesario, luego edita ligeramente la variable objetivo o el valor, en lugar de hacer clic nuevamente a través de Select y el Menú de Selección de Valor desde cero.
• Agrupa acciones que pertenecen juntas: si múltiples acciones Set / Record Variable generalmente van juntas, planifica el diseño de tu evento en torno a un Action Group que las albergue. Mover o copiar todo el conjunto más tarde es más rápido que manejar cada acción individualmente.
• Verifica primero la Configuración de Evento Automatizada: en algunos casos, como el seguimiento ocular, la detección de emociones o la frecuencia cardíaca, Labvanced puede ofrecer crear el desencadenador y su acción Set / Record Variable para ti. Verifica si ese cuadro de diálogo está disponible antes de configurar lo mismo manualmente.

Estudios y Escenarios de Ejemplo

Dos ejemplos reales de tareas publicadas en Labvanced, uno puntuando una sola respuesta y otro grabando movimiento continuo.

Puntuando la exactitud en la Tarea Flanker

En la tarea Main_task_desktop_Flanker de la Tarea Flanker, en el Marco 3 (Response Window), un Requirement Action dentro del evento Response Recording & Progression verifica si la tecla presionada coincide con la dirección objetivo. Cuando lo hace, Set / Record Variable establece la variable accuracy a 1.

Grabando datos de trayectoria del ratón

La configuración de seguimiento de ratón del Web Bridge utiliza Set / Record Variable para escribir el valor específico del desencadenador Mouse [Name, Info, X, Y] Array en una variable en cada movimiento del ratón. Establece el Formato a Array, el Tipo de Grabación a Time series, y el Método de Muestreo a record all (allow repeated duplicates), por lo que cada movimiento se captura en lugar de solo el más reciente.

Lectura Adicional y Materiales Abiertos

Sistema de Eventos

La referencia completa para cada desencadenador y acción en Labvanced.

Menú de Selección de Valor

Cómo definir constantes, variables, valores específicos de desencadenadores y expresiones como el valor asignado por esta acción.

Acción de Requisito (If... Then... Else If)

El bloque de lógica condicional que más comúnmente activa Establecer / Grabar Variable dentro de sus ramas Then y Else.

Creando Variables

Cómo crear una variable y establecer su tipo de dato, formato y opciones de grabación antes o mientras se utiliza esta acción.