Cada plataforma JMP genera una visualización única, pero hay características y objetos comunes en el diseño del informe. La característica más familiar en un informe JMP es el cuadro de esquema. La mayoría de los usuarios de JMP probablemente han editado el título de un cuadro de esquema o han activado el botón para mostrar u ocultar los gráficos y análisis que pertenecen a ese cuadro de esquema.
El siguiente paso es aprender los equivalentes JSL de estas tareas de interfaz de usuario, como cambiar el título del cuadro de esquema o alternar el ícono de divulgación ◢.
Se requieren dos habilidades específicas para editar la capa de informe. Uno es usar los mensajes JSL válidos y la sintaxis adecuada para la función de visualización de destino. El otro es encontrar la dirección de la función que se va a cambiar. A esta última habilidad la llamamos navegación.
Mostrar estructura de árbol
La navegación casi siempre comienza con un mapa. Ejecute el siguiente script para generar un informe. Luego, haga clic derecho en el ícono de divulgación ◢ ubicado a la izquierda del cuadro de esquema titulado "Análisis unidireccional de la altura por sexo". Seleccionar Editar ► Mostrar estructura de árbol . (Consulte la Figura 6.5.)
bigclass_dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
bigclass_ht_onew = bigclass_dt << Oneway(
Y( :height ), X( :sex ), Ignore Platform Preferences( 1 ),
Box Plots( 1 ), Means and Std Dev( 1 ), X Axis Proportional( 0 ),
Mean Error Bars( 0 ), Std Dev Lines( 0 )
);
Figura 6.5 Menú Editar—Mostrar estructura de árbol: (L) Informe completo (R) Eje Y
La estructura de árbol se muestra en una nueva ventana. Es una lista jerárquica anidada (sí, una lista) de cuadros de esquema, donde cada cuadro de esquema representa un cuadro de visualización JMP utilizado en el informe. Debido a que se seleccionó el botón de revelación superior, se muestra la estructura de árbol para todo el informe. Debe desplazarse hacia abajo para ver la estructura de árbol completa. La Figura 6.6 (L) muestra esta estructura de árbol después de hacer clic con el botón derecho en el botón de revelación superior, seleccionando Cerrar todo a continuación y luego abriendo selectivamente algunos elementos.
Figura 6.6 Estructura de árbol: Informe vinculado con FrameBox(1) resaltado
Alinee la ventana de estructura de árbol y el informe unidireccional. Pase el mouse sobre el botón revelar para cuadro de marco(1) y ver la pantalla correspondiente resaltada en el informe unidireccional. Consulte la Figura 6.6 (R). Tenga en cuenta la lista de SiCuadro( ) elementos en el árbol. Pase el cursor sobre cada icono de revelación. Si caja (1) contiene el contorno de la parte del gráfico de la pantalla. Si Caja(4) corresponde a la Medias y desviaciones estándar mesa. El Si caja contenedor muestra u oculta su contenido según las opciones del objeto: si se especifica la opción booleana, mostrar; si no, escóndete.
Cada ícono de divulgación en la ventana del informe tiene la misma interfaz de usuario. Esto permite al usuario mostrar la estructura de árbol para una porción más pequeña de la ventana del informe. La Figura 6.5 (R) muestra que al hacer clic con el botón derecho en una función de la ventana del informe, como el eje Y, se muestra un menú ( Editar ► Mostrar estructura de árbol) . En otras palabras, la estructura de árbol se puede solicitar para más que cuadros de contorno.
Cierre la estructura de árbol para todo el informe. Haga clic con el botón derecho en el botón de revelación a la izquierda del cuadro de contorno titulado "Medios y desviaciones estándar" y cree la estructura de árbol. Repita los mismos pasos, pero esta vez mantenga presionada la tecla SHIFT mientras selecciona Mostrar estructura de árbol . Consulte la Figura 6.7.
Figura 6.7 Estructura de árbol de medias y desviaciones estándar de análisis unidireccional: formato predeterminado interactivo (L) Formato clásico (R)
Ambos formatos de estructura de árbol muestran los objetos utilizados para organizar la salida. Cada objeto tiene la palabra "box" en su nombre (por ejemplo, OutlineBox, TableBox, StringColBox y NumberColBox). Para ambos formatos, la disposición de los objetos es una estructura jerárquica anidada. La estructura de árbol predeterminada interactiva (L) recuerda a un esquema. El formato clásico (R) recuerda a un organigrama (org).
El resaltado interactivo de la estructura de árbol predeterminada es útil para hacer coincidir el informe con los cuadros de visualización de sus componentes. Sin embargo, es largo y puede ser difícil discernir la estructura básica hasta que se cierran los iconos de divulgación seleccionados estratégicamente. El uso de la estructura de árbol de formato clásico puede facilitar la visualización de las relaciones de los objetos en el informe. Por ejemplo, la relación de NumberColBox(6) a TableBox(1) es inmediata en este organigrama como visualización.
Ambos formatos son informativos. A veces nos fijamos en ambos. Para cualquier formato, la estructura de árbol de una parte del informe será más fácil de leer que la estructura de árbol de todo el informe.
Hacer referencia a la capa de informe
Un cambio en la capa de análisis requiere que se envíe un mensaje válido al objeto de plataforma o al objeto de referencia para esa plataforma. Para el ejemplo actual, la plataforma es Oneway y el identificador es la referencia variable bigclass_ht_onew .
//Message to the Analysis Layer
bigclass_ht_onew << Points Jittered(1);
De manera similar, para cambiar los objetos de visualización, se debe enviar un mensaje válido a la capa de informe. Las dos formas de asignar una referencia de variable a la Capa de Informe son las siguientes:
//These two lines assign a variable name to the report,
//either syntax is acceptable
rpt_bc_ht_onew = Report( bigclass_ht_onew );
rpt_bc_ht_onew = bigclass_ht_onew << Report;
Para cambiar una función de visualización, se debe enviar el mensaje válido a la dirección del objeto de visualización. El Informe mensaje (o función) devuelve una dirección para el objeto de visualización de destino. Para los dos ejemplos anteriores, rpt_bc_ht_onew almacena la dirección para la visualización de análisis de sentido único, la capa de informe de sentido único. Revise los mensajes del cuadro de esquema que se muestran en la Figura 6.5 (L). Usando la dirección del informe, el anidamiento y las direcciones de los cuadros que se ven en la estructura de árbol, este siguiente conjunto de declaraciones debería ser evidente:
bigclass_ht_onew << Bring Window to Front;
//line up this script and this window, run 1 line at a time
rpt_bc_ht_onew[OutlineBox(1)] << Close;
rpt_bc_ht_onew[OutlineBox(1)] << Open All Below;
rpt_bc_ht_onew[OutlineBox(1)] << Close(1);
rpt_bc_ht_onew[OutlineBox(1)] << Close(0);
Cada objeto de visualización ( ContornoCuadro , TableBox , CadenaColBox ) pertenece a una clasificación más amplia llamada display box. El nombre ContornoCuadro (o NúmeroColBox , etc.) es el nombre de clase de un objeto. Una habilidad fundamental para aprender es atravesar la estructura de árbol, que se analiza en la sección "Navegar por un informe" en este capítulo.
JMP facilita la búsqueda de mensajes válidos para la mayoría de los objetos de cuadro de visualización. En el índice de secuencias de comandos de JMP, seleccione Cuadro de presentación ► ContornoCuadro . Primero, observe los mensajes que son comunes con la lista de opciones de menú que se muestra en la Figura 6.5. Encuentra el mensaje Cerca . Su descripción indica que este mensaje tiene un argumento booleano. Mire los scripts de muestra para Obtener título y Establecer título, y ejecute la siguiente instrucción JSL:
rpt_bc_ht_onew[OutlineBox(1)] << Set Title("Limit Mousing via JSL");¡Felicidades! Acaba de aprender los equivalentes de JSL para revelar u ocultar, y para cambiar el título de un cuadro de esquema.
Ofrecemos una habilidad más útil antes de dejar esta sección: la capacidad de seleccionar y anular la selección de partes de la capa de informe usando los mensajes Seleccionar y Deseleccionar . Estos dos mensajes están disponibles para cada tipo de cuadro de visualización y se pueden utilizar para resaltar una parte de la pantalla. Aquí usamos estos dos mensajes para probar si la dirección de un cuadro de visualización es correcta antes de cambiar el cuadro de visualización. Aquí hay un fragmento de 6_ReportLayer.jsl con retrasos programados para ver el proceso de selección:
rpt_bc_ht_onew[TableBox(1)] << Select;
wait(2);
rpt_bc_ht_onew[TableBox(1)] << Deselect;
rpt_bc_ht_onew[TableBox(1)][NumberColBox("Std Dev")] << Select;
wait(2);
rpt_bc_ht_onew[TableBox(1)][NumberColBox("Std Dev")] << Deselect;
El último par de Seleccionar y Deseleccionar declaraciones es una vista previa de la navegación del informe, que se describe en la sección "Navegar un informe". La ubicación del cuadro de visualización que se seleccionará se puede encontrar comenzando en la parte superior del informe y luego moviéndose hacia abajo hasta TableBox(1) . Dentro de TableBox(1) subordinados, encontrará el NúmeroColBox etiquetado Desv estándar .
Generar un informe y encontrar mensajes válidos para los objetos del cuadro de visualización es sencillo: use el Índice de secuencias de comandos para Caja de presentación . Navegar por un informe simple también puede ser sencillo. Pero hay más que aprender y la navegación puede resultar complicada cuando el informe es más complejo o cuando el análisis involucra muchas columnas Y, X y Por. La siguiente sección, "Secuencias de comandos de cuadros de visualización", recomienda una lista de lectura para abordar la larga lista de cuadros de visualización y sus mensajes.
El contenido de este blog fue condensado de un extracto de nuestro libro, JSL Companion: aplicaciones del lenguaje de secuencias de comandos JMP®, segunda edición , donde encontrará más técnicas y ejemplos de trabajo con el lenguaje de scripting JMP.
