Variables

Descripción

Las variables se pueden usar para diferentes propósitos en el proceso de creación de experimentos en Labvanced. Las variables mantienen 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 de manera global en todo el experimento. Hay una pestaña "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 utilizan 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 dato y el nombre. Las variables se pueden copiar, eliminar y seleccionar para inspeccionar y cambiar otras propiedades. Dentro del editor de tareas de Labvanced, y especialmente dentro del sistema de eventos, hay varios lugares donde se debe seleccionar una variable 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 ícono "Nueva Variable" en la pestaña de variables.

Un cambio realizado en una variable puede desencadenar un evento, pero lo contrario 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 Usadas.

Propiedades de la Variable

Para cada variable, los usuarios pueden determinar diferentes propiedades y proporcionar una breve descripción que resuma para qué se usa la variable. Las propiedades de "nombre" y "tipo de dato" son obligatorias, mientras que las otras propiedades son opcionales o no se pueden cambiar dependiendo del tipo de dato. A continuación se muestra 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 de nombre se puede cambiar en todas las variables excepto en las Variables del Sistema.
• Valores Posibles: Cualquier cadena ASCII.

Tipo de Dato

• Descripción: El tipo de dato de una variable determina qué tipo de valores puede tener la variable. El tipo de dato 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: Cualquier texto se puede almacenar 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 fijos predefinidos 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 hora en el formato (horas/minutos/segundos).
  • Archivo: La variable puede contener datos de archivo 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 tipo de dato 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 de Intervalo (escala sin un verdadero punto cero, p.ej. temperatura).
  • Proporción: Valor Escalado de Proporción (escala con un verdadero punto cero, p.ej. peso).

Formato

• Descripción: El formato de una variable determina si la variable es un valor único (escalar) o un array de valores. Algunas operaciones / acciones solo se pueden aplicar a arrays y otras solo a variables escalares.
• Valores Posibles:
  • Escalar: La variable es un solo valor.
  • Array: La variable contiene un rango de valores.
  • Data Frame: Hay varias variables anidadas en un archivo CSV. Elegir Data Frame 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 un cierto valor. El valor inicial también se puede usar para almacenar de manera permanente información en una variable (p.ej., texto, imagen, datos de video o audio).
• Valores Posibles: Depende del tipo de dato. Usar el ícono de reinicio para eliminar el valor inicial.
  • Variables con formato de dato "array": Para las variables "array", es posible no solo definir un valor inicial, sino llenar un array completo con valores. Por ejemplo, el usuario puede subir una lista de palabras (archivo CSV), imágenes, videos, archivos de audio, etc. en una variable array. La posición de los elementos / entradas dentro del array también puede ajustarse.

Reiniciar al Inicio del Ensayo

• Descripción: La opción "reiniciar al inicio del ensayo" determina si la variable se reiniciará al valor inicial para cada nuevo ensayo o no. Típicamente, esta opción debe estar activada para las 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 arrays de datos que almacenan información de manera persistente no deben reiniciarse.
• Valores Posibles: Si está marcado (verdadero), la variable se reiniciará al valor inicial. Si está desmarcado (falso), la variable no se reiniciará.

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 se registrarán al final de cada ensayo.
• Valores Posibles: Si está marcada (verdadero), la variable será registrada. Si está desmarcada (falso), la variable no será registrada.

Tipo de Registro

• Descripción: El tipo de registro de una variable determina si se registrarán todos los cambios de valor de una variable durante un ensayo, o solo el valor final de la variable en cada ensayo. Si se registran todos los cambios, cada cambio de variable se guardará junto con una marca de tiempo. Esta opción se puede usar para registrar una serie temporal de datos (p.ej., para seguimiento de mouse o seguimiento ocular).
• Valores Posibles:
  • Todos los cambios / serie temporal: 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 o 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 los 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 dato categórico. Los niveles del factor también son posibles estados de valor de la variable. Al crear un nuevo factor, los usuarios pueden optar por crear una nueva variable (automáticamente) o reutilizar una variable existente. Al vincular variables de factor, debe tenerse en cuenta que los cambios en la variable / los niveles de factor cambiarán la estructura del ensayo en todas las tareas / grupos de ensayos 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 tendrá siempre 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 tal 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 bajo "variable vinculada". Aquí también puedes cambiar la vinculación / asociación a una variable diferente. Sin embargo, sugerimos usar esta opción con especial cuidado. Durante la ejecución del experimento, la respuesta del participante se almacenará dentro de la variable. Las variables de objeto se registrarán de forma predeterminada 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 las decisiones de los participantes (clics del mouse o pulsaciones de teclas) o tiempos de reacción. También pueden usarse como contadores o índices en ciclos while o acciones de array, para almacenar datos de archivos (de imagen, video, audio), y para muchos otros propósitos.

Cuando una variable es creada sin ser utilizada, o cuando su uso (objeto o evento) se elimina, la variable se enumerará como no utilizada.

Variables de Array

Los arrays son muy diferentes de las variables escalares discutidas anteriormente. Piensa en un array como una columna en una hoja de cálculo: contiene entradas en un orden específico. Cuando creas un array, puedes hacer clic en la carpeta junto a "Usar archivo CSV" para subir un archivo .csv con una columna de información, o puedes agregar entradas manualmente usando el ícono de más.

Para una lista de acciones asociadas con arrays, consulta Acciones de Array

Variables de Data Frame

Los data frames son diferentes de los arrays en el sentido de que si un array es una columna de una hoja de cálculo, un data frame es una hoja de cálculo completa con varias columnas. Los data frames pueden contener valores de cadena (texto), numéricos, booleanos o de archivo, pero no se pueden editar directamente en la ventana del diálogo de data frame. Puedes agregar columnas y archivos, pero no puedes escribir texto o números:

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

Elige todas las que correspondan:

• Mapear Cadenas a Archivos te permite incluir los nombres de tus archivos como cadenas, luego usar la función de mapa para apuntar a la carpeta donde están almacenados los archivos. Esto permitirá que esa columna de nombres de archivos busque los archivos correspondientes en una carpeta, siempre que los valores en el data frame 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 en la primera fila de tu data frame y los usa como los nombres de las variables para cada una de las columnas.
• Transponer Datos simplemente sube el data frame tal como está. Esto es útil si tu data frame no contiene nombres de archivos.

Si tu data frame consiste completamente en valores de cadena que corresponden a los nombres de archivos en una carpeta, puedes mapear todo el data frame a una carpeta utilizando la función mapear todas las cadenas a archivos.

Para agregar más información a un data frame existente, elige la opción Agregar variable / columna en la parte superior del cuadro de diálogo de Data Frame.

Para una lista de acciones asociadas con data frames, consulta Operaciones de Data Frame

Referencias de Variables y Eliminación de Variables

Para proporcionar una mejor visión general de dónde se usa 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, incluida una referencia al marco en el que 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 extra 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 en la sección "variables locales" en el menú de selección de variables.

Cuando desees eliminar una variable, debe hacerse con especial cuidado. Eliminar variables que aún se utilizan como factores, objetos o que se utilizan en eventos puede llevar a problemas graves 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 se muestra un ícono de eliminación junto a ellas.

Menú de Selección de Variables

El uso controlado de variables por el usuario 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 Valor", el "Botón de Selección Verde" y el "Menú de Referencia de Variables." Aunque 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 por ende 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 las variables del sistema, las variables de factor y las variables de objeto, las grabaciones se activan de forma predeterminada. Por lo tanto, muchas partes de las grabaciones de datos funcionarán automáticamente. Cuando desees grabar una cierta propiedad de objeto, una respuesta del participante o algo más que no se graba 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 desencadenante que determina cuándo se debe establecer el valor de la variable. Por ejemplo, Seleccionar --> Entrada de Usuario --> Desencadenante de Mouse. Establece la acción de desencadenante como Clic y el Botón como Izquierdo. Haz clic en el signo + junto a Agregar Objetivos para agregar la imagen como un objetivo clicable. Haz clic en Siguiente en la parte inferior de la ventana.
4. Selecciona la acción Acciones de Variable --> Establecer / Registrar 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 dato: numérico, reiniciar = verdadero, registrar = verdadero). Haz clic en "Ok."
6. Haz clic en el ícono de Selección de Valor (pluma) --> Desencadenador (Mouse) --> Tiempo Desde el Inicio del Marco. Haz clic en Terminar.

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