3 - Especificación de Variables eMAPS

Para facilitar el procesamiento planteamos un protocolo de especificación para procesamiento de las variables de la metodología que consiste en definir un lenguaje de procesamiento que permita representar el valor en el que cada variable afecta el score de caminabilidad en el segmento de calle, permitiendo así abstraer del lenguaje de programación o software utilizado para el cálculo del score.

El lenguaje de procesamiento consiste en un archivo de texto plano separado por comas (CSV) que puede ser editado fácilmente en un software de hoja de cálculo como LibreOffice Calc, Microsoft Excel, Google Sheets, etc.

La estructura del archivo de texto es la siguiente.

Estructura

Columna	Descripción	Dato	Observación
variable	Código de la variable	Texto	Debe coincidir con la codificación de la pregunta en el formulario KoboToolBox
desc	Descripción de la variable	Texto
alias	Alias para describir la variable	Texto	Alias que será utilizado para nombrar las variables en archivos de salida de resultados
level	Nivel de la pregunta	segment / parcel	Indica si la pregunta corresponde a nivel de Segmento o Parcela
section	Sección de la variable	Texto	Indica la sección a la que pertenece la variable
scale	Escala de la variable	Texto	Indica la escala a la que pertenece la variable
subscale	Sub-escala	Texto	Indica la sub-escala a la que pertenece la variable
aggregate	Agregación	TRUE / FALSE	indica si la pregunta es agregada desde otras preguntas
aggregate_ref	Referencia de agregación	variable	Inidca el código de la pregunta a la que se agrega la variable actual
type	Tipo de cálculo	TIPO	Indica el tipo de calculo sobre la variable
		bool	Asigna un valor de acuerdo al valor booleano de la variable: ej	True=1 False=0
		formula	Asigna un valor de acuerdo a una fórmula	([value]/[segment_length])*100
		max	En preguntas de agregación, indica que asigna el máximo valor de las preguntas agregadas
		min	En preguntas de agregación, indica que asigna el mínimo valor de las preguntas agregadas
		avg	En preguntas de agregación, indica que asigna el valor promedio de las preguntas agregadas
		count	En preguntas de agregación, indica que asigna número de preguntas agregadas
		num_in_parcels	Asigna el valor agregado de número de parcelas que tienen la variable, se procesa como una pregunta numérica
		numeric	Asigna un valor de acuerdo a reglas aplicadas al valor numérico de la variable ej:	(>=0, <0.9)=0	(>=0.9)=1	*=0
		option	Asigna un valor de acuerdo a reglas sobre cadena de texto de la variable ej:	A=0:En acera	B=1:En calzada	C=0:No existe
		proportion_building	Asigna un valor de acuerdo a la proporción de la ocurrencia de la variable en las parcelas construidas, para el número de parcelas construidas, se calcula como un valor numérico	(>0, <=0.25)=0	(>0.25, <=0.75)=1	*=0
		slope	Aplica reglas de valor numérico sobre el valor de porcentaje de la pendiente del segmento de calle	(>=0, <=0.05)=0 (>0.05, <=0.1)=-1
required	Requerido	TRUE / FALSE	Indica si la pregunta es obligatoria para el cálculo
sum_type	Tipo de operación	POSITIVE / NEGATIVE	Indica el tipo de operación de suma que realiza el cálculo
option_1	Configuración del cálculo de acuerdo al tipo de cálculo de cada pregunta	Texto	Indican las reglas de cálculo para cada pregunta

Para la construcción de las condiciones y reglas de cada variable se han establecido reglas de sintaxis para cada tipo de pregunta, y otras de carácter general, como se describe a continuación

NOTA: el protocolo evaluará todas las preguntas especificacas en el archivo CSV, se recomienda que en la especificación de variables consten todas las preguntas del formulario de levantamiento de información par facilitar modificaciones o variaciones en la asignación de puntajes, para las preguntas que se desea excluir en el cálucolo utilizar la opción «required=FALSE» .

Reglas de sintaxis generales:

• Todas las reglas se evalúan de izquierda a derecha,
• El valor se asigna al segmento una vez cumpla una condición,
• Una vez se cumple una condición se ignoran las siguientes reglas
• Si no cumple ninguna condición y no existe una regla para cualquier otro valor (*=N) se asignará el valor 0
• Si una pregunta está presente en el protocolo de calificación y no en los datos de entrada se producirá un error de sintaxis.

Comentarios:

# Representa el inicio de una línea de comentario, no será interpretada en el análisis.

Regla cualquier otro valor.- aplica la puntuación para cualquier valor que no ha cumplido las reglas previamente establecidas:

*={PUNTUACION}

ejemplo:

Reglas de puntajes:

Las reglas para asignación de puntajes tienen el siguiente formato:

{VALOR}:{PUNTUACION}:[{DESCRIPCION}]

Donde {VALOR} representa el valor que puede tener la pregunta evaluada, {PUNTUACION} representa el valor que se asignará si la respuesta de la pregunta evaluada es igual a {VALOR} y {DESCRIPCION} es una descripción de la regla y es de carácter opcional

Una pregunta puede tener una o mas reglas de puntuación de acuerdo al tipo de pregunta y a los posibles valores de acuerdo a la configuración de la pregunta en el formulario de evaluación.

Pregunta de tipo Bool

Representa a preguntas de tipo verdadero/falso ejemplo:

{TRUE | FALSE} = {PUNTUACION} {:[COMENTARIO]}

ejemplo:

variable	Q_008a
desc	Semáforo vehicular - inicial
alias	seg_semaforo_vehicular_ini
level	segment
section	building
scale	intersections
subscale	intersections_positive
aggregate
aggregate_ref	Q_008
type	bool
required	TRUE
sum_type	positive
option_1	True=1:Verdadero
option_2	False=0:Falso

Para la variable de ejemplo Q_008a se evaluará cada encuesta asignando el puntaje 1 cuando la respuesta es Verdadero y 0 cuando la respuesta es Falso

Pregunta de tipo Numérico:

Evalúa una expresión numérica mediante reglas de comparación utilizando los operadores (<, >, <=, >=):

En éste tipo de preguntas opcionalmente puede utilizar paréntesis para agrupar las condiciones y facilitar la lectura de la expresión

La condición para tipo numérico tiene la siguiente sintaxis:

[(] {>|<|>=|<}={VALOR}, {>|<|>=|<=}={VALOR}, …   [)] = {PUNTUACIÓN} [:{COMENTARIO}]

variable	Q_008
desc	Semáforo - inicial
alias	seg_semaforo_ini
level	segment
section	building
scale	intersections
subscale	intersections_positive
aggregate	TRUE
aggregate_ref
type	numeric
required	TRUE
sum_type	positive
option_1	(>=1, <=6)=1
option_2	(>=7)=2
option_3	*=0

Para la variable de ejemplo Q_008 se evaluará cada encuesta asignando el puntaje 1 si la respuesta a la pregunta en la encuesta es >=1 y <=6, obtendrá un valor de 2 cuando la respuesta cumple >=7 y se asignará 0 en cualquier otro caso.

Pregunta de tipo Texto:

Evalúa una expresión de cadena de texto, su seintaxis es:

{VALOR}={PUNTUACION} [:{DESCRIPCION}]

Ejemplo:

variable	Q_023
desc	Construcciones bien mantenidas
alias	build_maintenance
level	parcel
section	building
scale	building_positive
subscale	building_maintenance
aggregate
aggregate_ref	Q_023_SEG
type	option
required	TRUE
sum_type	positive
option_1	A=1:Bueno (76-100%)
option_2	B=0:Regular (51-75%)
option_3	C=0:Malo
option_4	D=0:Precario
option_5	E=0:N/S o N/A

Para la variable de ejemplo Q_023 se evaluará cada encuesta asignando el puntaje: 1 si la respuesta es A, 0 si las respuestas son B o C o D o E

NOTA: en éste caso se podría haber utilizado la regla «cualquier otro valor» para indicar las opciones que asignan ``0`` al puntaje, sin embargo para mejor legibilidad se recomienda que consten todas las opciones de respuesta del formulario de levantamiento.

Pregunta de tipo Fórmula

Evalúa una pregunta aplicando una fórmula sobre el valor de la respuesta en el formulario.

la fórmula puede contener operadores matemáticos:

Operador	Descripción	Ejemplo
«+»	Suma	3+2 # r es 5
«-»	Resta	4-7 # r es -3
«-»	Negación	-7 # r es -7
«*»	Multiplicación	2*6 # r es 12
«**»	Exponente	2**6 # r es 64
«/»	División	3.5/2 # r es 1.75
«//»	División Entera	3.5//2 # r es 1.0
«%»	Módulo	7%2 # r es 1

y las siguientes variables:

Variable	Descripción
[value]	Expresa el valor que se está evaluando
[segment_length]	Expresa la longitud del segmento de calle que se está evaluando
[segment_slope]	Expresa la pendiente del segmento que se está evaluando

Ejemplo:

variable	Q_040_l
desc	Luminarias - Lado izquierdo
alias	seg_acera_luminarias_izq
level	segment
section	streetscape
scale	streetscape_positive
subscale	lighting
aggregate
aggregate_ref	Q_040
type	formula
required	TRUE
sum_type	positive
option_1	([value]/[segment_length])*100

Pregunta de tipo Slope (Pendiente)

Aplica reglas de valor numérico sobre el valor de porcentaje de la pendiente del segmento de calle evaluado, ejemplo:

variable	Q_SLOPE
desc	Pendiente
alias	seg_pendiente
level	segment
section	streetscape
scale	streetscape_negative
subscale	slope
aggregate
aggregate_ref
type	slope
required	TRUE
sum_type	negative
option_1	(>=0, <=0.05)=0
option_2	(>0.05, <=0.1)=-1
option_3	(>0.1, <=0.15)=-2
option_4	(>0.15)=-3
option_5	*=0

Para la variable de ejemplo Q_SLOPE se evaluará el porcentaje de pendiente del segmento de calle y asignará el valor de acuerdo a la evaluación de las reglas, en el ejemplo asignando un valor negativo para pendientes mayores a 0.05

Preguntas Agregadas

Aplica a todas las preguntas cuyo parámetros aggregate sea TRUE y realiza el procesamiento de la siguiente manera:

• Realiza el cálculo para todas las preguntas que tiene relación de agregación, ésta relación de agregación se establece en el parámetro aggregate_ref de la pregunta, y deberá contener el código de la pregunta a la que se agregará el resultado.

• Obtiene el valor agregado de las preguntas hijas, aplicando las siguientes condiciones que puede establecer el parámetro “type” de la pregunta:

  • «sum» aplica como resultado la suma de las preguntas hijas evaluadas
  • «max» aplica como resultado el valor máximo de las preguntas hijas evaluadas
  • «min» aplica como resultado el valor mínimo de las preguntas hijas evaluadas
  • «count» aplica como resultado el valor del número de preguntas hijas evaluadas
  • «avg» aplica como resultado el valor promedio de las preguntas hijas evaluadas
  • «Numeric» aplica las reglas de tipo “numérico” a la suma de las preguntas hijas evaluadas
  • «Formula» aplica las reglas de tipo formula a la suma de las preguntas hijas evaluadas

Ejemplo:

Pregunta de agregación:

variable	Q_037
desc	Basureros Públicos en Acera
alias	seg_acera_basureros
level	segment
section	streetscape
scale	streetscape_positive
subscale	trash_cans
aggregate	TRUE
aggregate_ref
type	numeric
required	TRUE
sum_type	positive
option_1	(>0)=1
option_2	*=0

Preguntas agregadas o hijas:

variable	Q_037_l
desc	Basureros Públicos en Acera - Lado izquierdo
alias	seg_acera_basureros_izq
level	segment
section	streetscape
scale	streetscape_positive
subscale	trash_cans
aggregate
aggregate_ref	Q_037
type	numeric
required	TRUE
sum_type	positive
option_1	(>0)=1
option_2	*=0

variable	Q_037_r
desc	Basureros Públicos en Acera - Lado derecho
alias	seg_acera_basureros_der
level	segment
section	streetscape
scale	streetscape_positive
subscale	trash_cans
aggregate
aggregate_ref	Q_037
type	numeric
required	TRUE
sum_type	positive
option_1	(>0)=1
option_2	*=0

En el ejemplo con la propiedad aggregate = TRUE definimos la pregunta de agregación Q_037 y mediante la propiedad aggregate_ref relacionamos las preguntas Q_037_l y Q_037_r.

Interpretamos el resultado de la suma de puntajes de las preguntas hijas mediante evlauación tipo «Numeric», es decir, si en el segmento de calle hay al menos un elemento «Basurero público en acera» el segmento de calle obtiene un puntaje de 1 caso contrario 0.

NOTA: Para casos que se requiera, se pueden anidar las agregaciones en varios niveles