7 FUNCIÓN ici

ici es la función principal del paquete ici para R, y permite calcular los índices de condición de un conjunto de unidades de evaluación, a partir cualquier número de variables organizadas en cualquier número de dimensiones. La función calcula tanto los índices de condición de cada una de las dimensiones, como el ICI.

La función calcula los índices con base en la información que se alimente en un único libro Excel, admitiendo dos formatos de entrada, acorde con la manera en que se haya registrado la información durante el diagnóstico (cf. capítulo 5).

1. Formato de marcas: Este libro consta de 4 hojas:
   • Hoja 1: Variables con una marca de estado en la correspondiente categoría de cada UE.
   • Hoja 2: Calificaciones de referencia para las diferentes categorías de cada variable.
   • Hoja 3: Ponderaciones de las variables sobre las dimensiones.
   • Hoja 4: Ponderaciones de las dimensiones sobre el ICI.
     
     
2. Formato de calificaciones: Este libro consta de 3 hojas:
   • Hoja 1: Variables con su calificación en cada UE.
   • Hoja 2: Ponderaciones de las variables en las dimensiones.
   • Hoja 3: Ponderaciones de las dimensiones sobre el ICI.
     
     

A continuación se muestra el aspecto de la primera hoja de un libro Excel en formato de marcas (izquierda) y en formato de calificaciones (derecha). Los libros Eje1m.xlsx y Eje1c.xlsx contienen la información completa para una evaluación en la que se ha usado cada uno de estos formatos. Cualquiera que sea el formato elegido, es posible incorporar en el mismo libro la información de múltiples unidades de evaluación (en este ejemplo se muestran 2 UE).

Formato de marcas	Formato de calificaciones

A continuación se detallan los dos formatos, usando los mismos datos con base en los cuales se desarrolló el ejemplo de manera semimanual en el libro Eje1_manual.xlsx (cf. capítulo 6).

7.1 Formato de marcas

Es el formato correspondiente a un diagnóstico realizado con base en una encuesta en formato de marcas (cf. capítulo 5). Tiene lugar cuando, al momento de construir la encuesta (sección 2.2), se definen las posibles manifestaciones de cada variable con base en una serie de categorías exhaustivas y mutuamente excluyentes, a cada una de las cuales se le ha hecho corresponder una calificación previamente (capítulo 3).

• Hoja 1. La columna A contiene los nombres (o cualquier otra etiqueta) de las variables. Para facilitar la visualización, bien pueden combinarse todas las celdas de las filas correspondientes a las diferentes categorías de la variable, aunque ello no es obligatorio; también podría ponerse el nombre de la variable en la fila correspondiente a la primera categoría. En la columna B aparecen los nombres (o cualquier otra etiqueta) de las diferentes categorías de cada variable. En las columna C y sucesivas se registra, mediante cualquier marca, el estado de la variable en la unidad evaluada (una columna por unidad de evaluación). Así, por ejemplo, en la primera unidad de evaluación (UE 1, columna C), la variable v1 exhibió el estado v1.1; la v2, el estado v2.1, mientras que el estado de v3 fue v3.2.

  Cuando una variable participe en más de una dimensión, debe aparecer una vez por cada dimensión. En el presente ejemplo, v3 con sus diferentes categorías aparece 2 veces: la primera vez (entre las filas 9 y 12) para la dimensión ambiental, y la segunda vez (filas 15 a 18) para la dimensión técnica. Análogamente, v7 aparece 3 veces: una para la dimensión ambiental, otra para la técnica y otra para la social.

  En estos casos, es necesario realizar la correspondiente adaptación del formato de marcas proveniente de la etapa de diagnóstico (cf. capítulo 5), en el que cada variable se registra una sola vez.

• Hoja 2. Contiene las calificaciones de referencia para cada una de las categorías de las variables consideradas. Estas calificaciones de referencia deben haber surgido de un proceso como el expuesto en la capítulo 3. Tales categorías deben aparecer en el mismo orden en el que se presentan en la Hoja 1.

• Hoja 3. Ponderaciones de las variables sobre las dimensiones.

• Hoja 4. Ponderaciones de las dimensiones sobre el ICI.

7.2 Formato de calificaciones

Es el formato que surge cuando el diagnóstico se realiza con base en una encuesta en formato de calificaciones (cf. capítulo 5), es decir, cuando no están identificadas las diferentes categorías en las que puede manifestarse cada variable, sino que las calificaciones se asignan directamente en campo, con base en el criterio del encuestador.

• Hoja 1. La columna A contiene los nombres (o cualquier otra etiqueta) de las variables. En las columna B y sucesivas se registran las calificaciones, usando una columna por cada unidad de evaluación. Esta hoja coincide con la del formato de calificaciones del diagnóstico (cf. capítulo 5).

• Hoja 2. Ponderaciones de las variables sobre las dimensiones.

• Hoja 3. Ponderaciones de las dimensiones sobre el ICI.

---

Cualquiera que sea el formato (marcas o calificaciones), las ponderaciones de las variables sobre las dimensiones se indican usando una columna para cada dimensión, pudiendo incluirse tantas dimensiones (columnas) como lo exija la herramienta. En el presente ejemplo, para la dimensión ambiental (columna B), las variables v1, v2, v3 y v7 registran ponderaciones de 5, 3.5, 4.5 y 5, respectivamente. Para indicar que una variable no aporta información sobre una dimensión determinada, puede usarse 0 (tal y como se hizo en el formato de marcas) o dejarse el espacio vacío (como se hizo en el formato de calificaciones). Aunque se considera que los espacios vacíos facilitan la visualización de las ponderaciones, el usuario puede elegir la opción que mejor se adapte a sus gustos y necesidades, pudiendo incluso usar una combinación de ambas.

Aunque a primera vista, los libros Excel, con todas su hojas, pueden parecer un poco recargados, debe notarse que, cualquiera que sea el formato utilizado, la única información que se manipula para la evaluación de una serie de unidades particulares es la de la primera hoja. La información que se consigna en la segunda hoja y subsiguientes corresponde a los ‘parámetros’ de la herramienta y permanecerá constante para una versión particular de esta; únicamente se modificaría en caso de actualización de la herramienta (cf. sección 9.1). El hecho de separar en diferentes hojas la información que se manipula y la que debe permanecer constante ayuda a preservar la integridad de la herramienta. Es de notar que los encuestadores que realizan el diagnóstico (cf. capítulo 5) no manipulan en ningún momento los ‘parámetros’ de la herramienta (ni siquiera tienen acceso a estos); los formatos que se usan durante el diagnóstico constan de una única hoja en la que se registra el estado de las unidades de evaluación.

La función ici tiene la siguiente sintaxis:

ici(data, format = c("m", "c"), ue = 1, esc = NULL, nc = 2, console = T,
    radar = T)

Mediante el argumento data se especifica el libro Excel que contiene la información que será procesada. El nombre debe escribirse con su correspondiente extensión y entrecomillado. El argumento format permite especificar cómo se registró la información: si en formato de marcas (7.1, por defecto) o de calificaciones (7.2). Por defecto, se procesa 1 unidad de evaluación (ue = 1); sin embargo, puede especificarse cualquier otro número de unidades que deban procesarse simultáneamente. El escalamiento se refiere a lo indicado en la sección 6.2; por defecto no se realiza ninguno, con lo cual la valoración de las diferentes dimensiones, así como del ICI aparecerá en la misma escala en la que se hayan calificado las variables básicas. Para aplicar algún tipo de escalamiento, debe ingresarse un vector en el que se especifiquen el mínimo (mi) y máximo (Mi) de la escala inicial, así como el mínimo (mf) y máximo (Mf) de la escala final. Así, si la escala original iba entre 1 y 5, y se desea usar una nueva escala, entre 0 y 100, debe incluirse el argumento esc = c(1, 5, 0, 100). El argumento nc permite especificar el número de constructos. Por defecto se trabaja (nc = 2), que corresponde a lo desarrollado hasta aquí. No obstante, en el capítulo 8 se presenta una generalización para obtener un ICI basado en un mayor número de constructos. Los resultados son enviados por defecto a la consola (console = T). En cualquier caso, ya sea que los resultados se muestren por consola o no, estos pueden asignarse a un data frame. El argumento lógico radar = T especifica la creación de un gráfico de radar para las unidades de evaluación.

Para calcular los índices basados en la información que aparece en el libro Eje1c.xls, se usa la siguiente instrucción:

ici("Eje1c.xlsx", "c", ue = 2)

Se obtiene por defecto el siguiente resultado por consola:

#> 
#>  Condition indexes for UE 1 
#>  
#>  Dimensión index
#>  Ambiental  4.88
#>    Técnica  2.97
#>     Social  4.05
#>  Económica  2.07
#> 
#>  hierarchy 2 index
#>          ICI  3.63
#> 
#>  Condition indexes for UE 2 
#>  
#>  Dimensión index
#>  Ambiental  1.28
#>    Técnica  4.20
#>     Social  1.00
#>  Económica  5.00
#> 
#>  hierarchy 2 index
#>          ICI  2.73

Puede obtenerse una una versión más compacta y manejable de estas salidas, almacenándolas en un data frame, que luego puede exportarse a un archivo Excel; para ello basta con asignar la salida de la función a un objeto.

res1a <- ici("Eje1c.xlsx", "c", ue = 2, console = F, radar = T)

UE	Ambiental	Técnica	Social	Económica	ICI
UE 1	4.875000	2.966667	4.05	2.071429	3.631117
UE 2	1.277778	4.200000	1.00	5.000000	2.731801

Para exportar el data frame a un archivo Excel, se usa la siguiente instrucción:

writexl::write_xlsx(res1a, "res1a.xlsx")

La función ici genera por defecto un gráfico de radar para las unidades de evaluación procesadas¹⁵.

Si los datos estuvieran almacenados en un libro Excel con formato de marcas, como Eje1m.xls, se usaría la siguiente instrucción, con la cual se obtendrían exactamente los mismos resultados.

ici("Eje1m.xlsx", ue = 2)

Para obtener índices escalados entre 0 y 100, se usa la siguiente instrucción:

ici("Eje1m.xlsx", ue = 2, esc = c(1, 5, 0, 100))

#> 
#>  Condition indexes for UE 1 
#>  
#>  Dimensión index
#>  Ambiental 96.88
#>    Técnica 49.17
#>     Social 76.25
#>  Económica 26.79
#> 
#>  hierarchy 2 index
#>          ICI 65.78
#> 
#>  All indexes have been scaled between 0 and 100 
#> 
#>  Condition indexes for UE 2 
#>  
#>  Dimensión   index
#>  Ambiental   6.944
#>    Técnica  80.000
#>     Social   0.000
#>  Económica 100.000
#> 
#>  hierarchy 2 index
#>          ICI  43.3
#> 
#>  All indexes have been scaled between 0 and 100

Asimismo, pueden obtenerse los índices para UE con calificaciones faltantes, sin que sea necesario incluir ninguna especificación adicional en la función o en los formatos. Para tal efecto, basta con dejar vacíos los espacios de las marcas o de las calificaciones, dependiendo del formato utilizado. En los libros Eje1mf.xlsx y Eje1cf.xlsx, que corresponden a los formatos marcas y calificaciones, respectivamente, se ha usado la misma información del ejemplo, retirando la información de 3 variables de la primera UE, y otras 3 de la segunda. Cuando se presente esta situación, se agrega un mensaje de advertencia en las salidas de las correspondientes UE¹⁶.

En caso de información faltante, deben dejarse vacíos los correspondientes espacios. No debe incluirse calificación 0 ni ninguna otra, como tampoco ninguna marca.

#> 
#>  Condition indexes for UE 1 
#>  
#>  Dimensión index
#>  Ambiental  5.00
#>    Técnica  3.83
#>     Social  4.05
#>  Económica  2.07
#> 
#>  hierarchy 2 index
#>          ICI  3.96
#> 
#>  Atention! Missing marks on 3 variables! 
#> 
#>  Condition indexes for UE 2 
#>  
#>  Dimensión index
#>  Ambiental  1.00
#>    Técnica  4.69
#>     Social  1.00
#>  Económica  5.00
#> 
#>  hierarchy 2 index
#>          ICI  2.82
#> 
#>  Atention! Missing marks on 3 variables!

Si alguna variable incluye categorías del tipo no aplica, como la ejemplificada al final de la sección 6.1, deberá dejarse en blanco la calificación de tales categorías¹⁷ en la Hoja 2 o en la Hoja 1, dependiendo de que se esté usando el formato de marcas o el de calificaciones, respectivamente.