Variables

Descripción

Las variables se pueden usar para diferentes propósitos en el proceso de creación de experimentos en Labvanced. Las variables contienen y actualizan valores que son creados ya sea en el editor por el experimentador o durante la ejecución del experimento por diferentes medios. Es importante destacar que todas las variables dentro de un estudio están definidas y se pueden usar globalmente a lo largo del experimento. Hay una pestaña de "Variables" en el panel de navegación principal, donde se enumeran todas las variables de un estudio.

Dentro del editor de tareas, las variables que se usan en el marco actualmente seleccionado se enumeran bajo la pestaña "Variables" en la esquina superior derecha de la pantalla. Aquí, cada variable se muestra con sus propiedades más importantes: la categoría principal, el tipo de datos y el nombre. Las variables se pueden copiar, eliminar y seleccionar para inspeccionar y cambiar más propiedades. Dentro del editor de tareas de Labvanced, y especialmente dentro del sistema de eventos, hay varios lugares donde una variable debe ser seleccionada para lograr una función deseada. Cuando se te pide que selecciones una variable, generalmente puedes seleccionar una existente, pero también puedes crear una nueva variable en ese momento. También puedes crear una nueva variable independientemente de seleccionarla / usarla. Esto se puede hacer haciendo clic en el icono de "Nueva Variable" en la pestaña de variables.

Un cambio realizado en una variable puede desencadenar un evento, pero lo inverso también es cierto: los eventos pueden cambiar el valor de una variable. Además, las variables pueden cambiar directamente el estado de ciertos objetos. Las variables se agrupan en 5 categorías principales: Variables del Sistema, Variables de Factor, Variables de Objeto, Variables Personalizadas y Variables No Utilizadas.

Propiedades de la Variable

Para cada variable, los usuarios pueden determinar diferentes propiedades y proporcionar una breve descripción de texto que resume para qué se utiliza la variable. Las propiedades "nombre" y "tipo de datos" son obligatorias, mientras que las otras propiedades son opcionales o no se pueden alterar según el tipo de datos. A continuación se incluye una lista de todas las propiedades, sus valores y descripciones.

Nombre

• Descripción: El nombre se utiliza como un identificador para la variable en eventos, objetos, al copiar tareas y más tarde también en la vista de datos. El nombre DEBE SER ÚNICO (no puede haber 2 variables con el mismo nombre). ¡De lo contrario, pueden ocurrir errores graves! La propiedad del nombre se puede cambiar en todas las variables excepto en las Variables del Sistema.
• Valores Posibles: Cualquier cadena ASCII.

Tipo de Datos

• Descripción: El tipo de datos de una variable determina qué tipo de valores puede tener la variable. El tipo de datos también determina qué tipo de operaciones matemáticas se pueden aplicar a una variable (la multiplicación solo funciona con variables numéricas, etc.).
• Valores Posibles:
  • Cadena: Se puede almacenar cualquier texto en la variable, incluidos números, caracteres especiales, etc.
  • Numérico: Solo se pueden almacenar valores numéricos en la variable.
  • Booleano: La variable solo puede tener los valores “verdadero” o “falso”.
  • Categórico: La variable tiene un conjunto de niveles predeterminados fijos y uno de los niveles debe ser el valor de la variable. Esto se utiliza principalmente para variables de factor.
  • Fecha: La variable solo puede contener valores de fecha en el formato (aaaa/mm/dd).
  • Hora: La variable solo puede contener valores de tiempo en el formato (horas/minutos/segundos).
  • Archivo: La variable puede contener datos de archivos de imágenes, videos o archivos de audio.

Escala

• Descripción: La escala de una variable determina el "nivel de medición" de la variable. Esta distinción es útil para variables con un tipo de datos numérico y define la relación de los valores de la variable. La propiedad puede tener más usos en una futura extensión de Labvanced, como un módulo de análisis.
• Valores Posibles:
  • Indefinido: Sin selección
  • Nominal: Valor escalado nominal (categorías).
  • Ordinal: Valor escalado ordinal (rangos).
  • Intervalo: Valor escalado por intervalo (escala sin un verdadero punto cero, por ejemplo, temperatura).
  • Proporción: Valor escalado por proporción (escala con un verdadero punto cero, por ejemplo, peso).

Formato

• Descripción: El formato de una variable determina si la variable es un único valor (escalar) o un arreglo de valores. Algunas operaciones / acciones solo se pueden aplicar a arreglos y otras solo a variables escalares.
• Valores Posibles:
  • Escalar: La variable es un solo valor.
  • Arreglo: La variable contiene un rango de valores.
  • Marco de Datos: Hay varias variables anidadas en un archivo CSV. Elegir Marco de Datos abre un cuadro de diálogo para especificar los datos CSV, donde cada columna es una variable. Los usuarios pueden elegir entre cadena, numérico, booleano o archivo como tipo de variable.

Valor Inicial

• Descripción: El valor inicial de una variable determina el valor predeterminado / de reinicio de la variable. El valor inicial se puede usar para restablecer el valor de una variable al inicio de cada ensayo a cierto valor. El valor inicial también se puede usar para almacenar información de manera permanente en una variable (p. ej., texto, imagen, datos de video o audio).
• Valores Posibles: Depende del tipo de datos. Usa el ícono de reinicio para eliminar el valor inicial.
  • Variables con formato de datos "arreglo": Para las variables "arreglo", es posible no solo definir un valor inicial, sino llenar un arreglo completo con valores. Por ejemplo, el usuario puede cargar una lista de palabras (archivo CSV), imágenes, videos, archivos de audio, etc. en una variable de arreglo. La posición de los elementos / entradas dentro del arreglo también se puede ajustar.

Reiniciar al Inicio del Ensayo

• Descripción: La opción "reiniciar al inicio del ensayo" determina si la variable se restablecerá al valor inicial para cada nuevo ensayo o no. Normalmente, esta opción debe activarse para variables que registran la respuesta o el tiempo de reacción de un participante. Sin embargo, las variables que acumulan datos a lo largo de los ensayos (para retroalimentación u otros propósitos) o los arreglos de datos que almacenan información de manera persistente no deben reiniciarse.
• Valores Posibles: Si está marcado (verdadero), la variable se restablecerá al valor inicial. Si está desmarcado (falso), la variable no se restablecerá.

Registrar Variable

• Descripción: La opción de registrar variable determina si la variable será registrada o no. Todas las variables donde esta opción esté habilitada serán registradas al final de cada ensayo.
• Valores Posibles: Si está marcado (verdadero), la variable será registrada. Si está desmarcado (falso), la variable no será registrada.

Tipo de Registro

• Descripción: El tipo de registro de una variable determina si todos los cambios de valor de una variable durante un ensayo serán registrados, o solo el valor final de la variable en cada ensayo. Si todos los cambios se registran, cada cambio de variable se guardará junto con una marca de tiempo. Esta opción se puede usar para registrar una serie de tiempo de datos (p. ej., para seguimiento del movimiento del mouse o de los ojos).
• Valores Posibles:
  • Todos los cambios / serie de tiempo: Registra todos los cambios de una variable incluyendo marcas de tiempo.
  • Solo valor final: Registra solo el último valor de una variable al final del ensayo.

Variables del Sistema

Las variables del sistema son importantes para la ejecución del experimento y la exportación de datos. Se crean automáticamente y no se pueden modificar ni eliminar. Las variables del sistema también son muy útiles en requisitos (p. ej., Acciones If-Else). Por ejemplo, se pueden usar para referirse a un número de ensayo específico, utilizar un contador de sujetos o separar eventos para estudios de múltiples usuarios entre participantes. Todas las variables del sistema se muestran en el menú principal de variables en la plataforma Labvanced. Aprende más sobre variables del sistema aquí.

Variables de Factor

Las variables de factor son aquellas variables que están vinculadas a un factor en el sistema de ensayos. Cada factor tiene una variable vinculada con un tipo de datos categórico. Los niveles del factor también son posibles estados de valor de la variable. Al crear un nuevo factor, los usuarios pueden elegir crear una nueva variable (automáticamente) o reutilizar una variable existente. Al vincular variables de factor, se debe tener en cuenta que los cambios en los niveles de la variable/factor cambiarán la estructura del ensayo en todas las tareas/grupos de ensayo vinculados. Las variables de factor se pueden usar en el sistema de eventos, por ejemplo, para crear eventos que se ejecutan solo en ciertas condiciones (p. ej., hacer algo solo si el factor "categoría de imagen" es igual a "casa"). Además, en cada ensayo durante la ejecución del experimento, cada variable de factor siempre tendrá un nuevo valor de nivel almacenado en la vista de datos. De esta manera, es más fácil reconstruir la condición de cada ensayo registrado al ver la salida de datos o repetir el procedimiento.

Variables de Objeto

Las variables de objeto se crean automáticamente cuando se agrega un objeto al marco. La mayoría de estas variables surgen de la adición de "elementos de cuestionario", como casillas de verificación, escalas de Likert, menús desplegables, etc. Al crear dicho objeto, se te pedirá que ingreses un nombre para la variable asociada. Después de ingresar un nombre válido (¡único!), la variable se creará automáticamente. En la vista de propiedades del objeto, verás la referencia a la variable asociada debajo de "variable vinculada". Aquí también puedes cambiar la vinculación/asociación a una variable diferente. Sin embargo, sugerimos usar esta opción con cuidado especial. Durante la ejecución del experimento, la respuesta del participante se almacenará dentro de la variable. Las variables de objeto se registrarán por defecto y la mayoría de las propiedades de las variables de objeto no se pueden cambiar para garantizar su funcionalidad.

Variables Personalizadas

Las variables personalizadas son creadas activamente por el usuario. Las razones para crear variables personalizadas pueden ser bastante diversas. Pueden usarse para registrar decisiones de los participantes (clics del mouse o pulsaciones de teclas) o tiempos de reacción. También se pueden usar como contadores o índices en bucles while o acciones de arreglos, para almacenar datos de archivos (imagen, video, audio), y para muchos otros propósitos.

Cuando se crea una variable sin ser utilizada, o cuando su uso (objeto o evento) es eliminado, la variable será listada como no utilizada.

Variables de Arreglo

Los arreglos son muy diferentes de las variables escalares discutidas anteriormente. Piensa en un arreglo como una columna en una hoja de cálculo: contiene entradas en un orden especificado. Al crear un arreglo, puedes hacer clic en la carpeta junto a "Usar archivo CSV" para cargar un archivo .csv con una columna de información, o puedes agregar entradas manualmente utilizando el icono de más.

Para una lista de acciones asociadas con arreglos, consulta Acciones de Arreglo

Variables de Marco de Datos

Los marcos de datos son diferentes de los arreglos en que si un arreglo es una columna de una hoja de cálculo, un marco de datos es una hoja de cálculo completa con múltiples columnas. Los marcos de datos pueden contener valores de texto (cadena), numéricos, booleanos o de archivo, pero no se pueden editar directamente en la ventana de diálogo del marco de datos. Puedes agregar columnas y archivos, pero no puedes escribir texto o números:

Para agregar un nuevo marco de datos, haz clic en Cargar Datos CSV 2D. Al agregar información a tu marco de datos, solo se aceptan archivos .csv. Después de elegir tu archivo, aparecerán varias opciones de importación:

Elige todas las que apliquen:

• Mapear Cadenas a Archivos te permite incluir los nombres de tus archivos como cadenas, y luego usar la función de mapeo para señalar la carpeta donde se almacenan los archivos. Esto permitirá que esa columna de nombres de archivos busque los archivos correspondientes en una carpeta, siempre que los valores en el marco de datos coincidan exactamente con los nombres de los archivos deseados. Esta función solo está disponible si la columna está poblada por valores de cadena.
• Usar la Primera Fila como Encabezado toma los valores de la primera fila de tu marco de datos y los utiliza como los nombres de las variables para cada una de las columnas.
• Transponer Datos simplemente carga el marco de datos tal como está. Esto es útil si tu marco de datos no contiene ningún nombre de archivo.

Si tu marco de datos consiste completamente en valores de cadena que corresponden a los nombres de los archivos en una carpeta, puedes mapear el marco de datos completo a una carpeta usando la función mapear todas las cadenas a archivos.

Para agregar más información a un marco de datos existente, elige la opción Agregar variable/columna en la parte superior del cuadro de diálogo del Marco de Datos.

Para una lista de acciones asociadas con marcos de datos, consulta Operaciones de Marco de Datos

Referencias de Variables y Eliminación de Variables

Para proporcionar una mejor vista general de dónde se utiliza cada variable, hay una lista llamada USADO EN en la parte inferior del panel de propiedades de la variable. Aquí, se enumeran todos los usos de la variable, incluyendo una referencia al marco en el cual se utiliza la variable (nombre), para qué propósito (Usado como), y si el uso es una operación de lectura (R), una operación de escritura (W), o ambas (RW). Para cada marco donde se utiliza una variable, habrá una entrada adicional en la tabla de uso con un "tipo de uso" llamado "espacio de trabajo local". Todas las variables en el espacio de trabajo local de un marco se mostrarán luego en la sección "variables locales" en el menú de selección de variables.

Cuando desees eliminar una variable, debe hacerse con cuidado especial. Eliminar variables que aún se utilizan como factores, objetos o que se usan en eventos puede llevar a problemas serios y (en el peor de los casos) puede interrumpir toda la estructura del experimento. Por lo tanto, en la pestaña de variables, solo se pueden eliminar aquellas variables que no tienen uso referido además de estar dentro de uno (o más) espacios de trabajo locales. Las variables que solo están definidas en el espacio de trabajo local (sin uso adicional) se enumeran como no utilizadas y un icono de eliminación se muestra junto a ellas.

Menú de Selección de Variables

El uso controlado por el usuario de variables se basa principalmente en la lógica de eventos. Dentro del sistema de eventos hay 3 menús (visualmente) diferentes que te permitirán seleccionar una variable: el "Menú de Selección de Valores", el "Botón de Selección Verde", y el "Menú de Referencia de Variables." Si bien estos menús son visualmente diferentes, abren el mismo menú (el Menú de Selección de Variables) para seleccionar una variable.

En general, el Menú de Selección de Variables contiene tres pestañas diferentes: "Variables Locales", "Todas las Variables" y "Nueva Variable." Bajo "Variables Locales," puedes ver y seleccionar todas las variables que están definidas en el espacio de trabajo local del marco (ya utilizadas en el marco). Bajo "Todas las Variables," se enumeran todas las variables en la lista global del estudio y se pueden seleccionar. Ambos de estos menús tienen una función de búsqueda para encontrar directamente una variable deseada. La pestaña "Nueva Variable" se puede usar para crear (y, en consecuencia, seleccionar) una nueva variable.

Grabación de Datos

Para cada variable, los usuarios pueden usar una casilla de verificación para decidir si el valor de la variable será grabado o no. Para variables del sistema, variables de factor y variables de objeto, las grabaciones están activadas por defecto. Por lo tanto, muchas partes de las grabaciones de datos funcionarán automáticamente. Cuando buscas grabar una cierta propiedad del objeto, una respuesta del participante, o algo más que no se grabe por defecto, debes usar el sistema de eventos para establecer el valor de la variable apropiadamente. Aquí hay un breve ejemplo de lógica de eventos para grabar el tiempo de reacción:

1. Agrega una imagen al marco.
2. Crea un Nuevo Evento y nómbralo.
3. Define el desencadenador que determina cuándo debe establecerse el valor de la variable. Por ejemplo, Seleccionar --> Entrada del Usuario --> Desencadenador del Mouse. Establece la acción del desencadenador como Clic y el Botón como Izquierdo. Haz clic en el signo + junto a Agregar Objetivos para añadir la imagen como un objetivo clickeable. Haz clic en Siguiente en la parte inferior de la ventana.
4. Selecciona la acción Acciones de Variable --> Establecer / Grabar Variable. Luego haz clic en el botón "Seleccionar".
5. Haz clic en la pestaña "Nueva Variable" y crea una nueva variable dándole un nombre (tipo de datos: numérico, reiniciar = verdadero, registrar = verdadero). Haz clic en "Ok."
6. Haz clic en el icono de Selección de Valor (pluma) --> Desencadenador (Mouse) --> Tiempo Desde el Comienzo del Marco. Haz clic en Finalizar.

Ahora has guardado el tiempo de reacción por hacer clic en una imagen. Puedes usar un procedimiento similar para grabar otras propiedades, como decisión (qué imagen fue clickeada de una variedad), etc.