Comando HISTOGRAM

Información de concepto

Agrupa registros sobre la base de los valores de un campo de caracteres o numérico, hace un recuento de la cantidad de registros de cada grupo y muestra los grupos y los recuentos en un gráfico de barras.

Sintaxis

HISTOGRAM {<ON> campo_caracteres|<ON> campo_numérico MINIMUM valor MAXIMUM valor {<INTERVALS número>|FREE valor_intervalo <...n> último_intervalo}} <TO {SCREEN|nombre_archivo|GRAPH|PRINT}> <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango> <HEADER texto_encabezado> <FOOTER texto_pie_de_página> <KEY salto_campo> <SUPPRESS> <COLUMNS número> <APPEND> <OPEN>

Parámetros

Nombre	Descripción
ON campo_caracteres	La expresión o el campo de caracteres que se debe utilizar para el histograma.
ON campo_numérico	La expresión o el campo numérico que se debe utilizar para el histograma.
MINIMUM valor	Se aplica sólo a campos numéricos. El valor mínimo del primer intervalo numérico. MINIMUM es opcional si se está utilizando FREE; de lo contrario, es obligatorio.
MAXIMUM valor	Se aplica sólo a campos numéricos. El valor máximo del último intervalo numérico. MAXIMUM es opcional si se está utilizando FREE; de lo contrario, es obligatorio.
INTERVALS número opcional	Se aplica sólo a campos numéricos. El número de intervalos de igual tamaño que Analytics genera en el rango especificado por los valores MINIMUM y MAXIMUM. Si no especifica un número de intervalos, se utiliza el número predeterminado. El valor predeterminado se especifica con el número Intervalos en la ficha Comando del cuadro de diálogo Opciones.
FREE valor_intervalo <...n> último_intervalo opcional	Se aplica sólo a campos numéricos. Crea intervalos de tamaño personalizado especificando el punto de inicio de cada intervalo y el punto final del último intervalo. Si especifica los valores MINIMUM y MAXIMUM, esos valores son el punto inicial del primer intervalo y el punto final del último intervalo, y cada valor_intervalo crea un intervalo adicional dentro del rango. Los valores del intervalo que especifique deben ser superiores al valor MINIMUM e iguales o inferiores al valor MAXIMUM. Los valores del intervalo deben estar en una secuencia numérica y no pueden tener valores duplicados: FREE -1000; 0; 1000; 2000; 3000 Si especifica tanto FREE como INTERVALS, se ignora INTERVALS.
TO SCREEN \| nombre_archivo \| GRAPH \| PRINT	El lugar al que se deben enviar los resultados del comando: SCREEN muestra los resultados en el área de visualización de Analytics Consejo Puede hacer clic en cualquier valor de resultado enlazado en el área de visualización para ver con mayor detalle el o los registros asociados de la tabla de origen. nombre_de_archivo guarda los resultados en un archivo Especifique el nombre_de_archivo como una cadena entre comillas con la extensión de archivo adecuada. Por ejemplo: TO "Salida.TXT" Por valor predeterminado, el archivo se guarda en la carpeta que contiene el proyecto de Analytics. Utilice una ruta de archivo absoluta o relativa para guardar el archivo en una carpeta existente o una diferente: TO "C:\Salida.TXT" TO "Resultados\Salida.TXT" GRAPH muestra los resultados en un gráfico en el área de visualización de Analytics PRINT envía los resultados a la impresora predeterminada Nota Los resultados del histograma que se envían a un archivo aparecen como una representación de texto de un gráfico de barras.
IF prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición. Nota El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT).
WHILE prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla. Nota Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite.
FIRST rango \| NEXT rango opcional	La cantidad de registros que se procesarán: FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado Utilice intervalo para especificar la cantidad de registros que se deben procesar. Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada.
HEADER texto_encabezado opcional	El texto que se debe insertar en la parte superior de cada página de un reporte. texto_encabezado_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema HEADER de Analytics.
FOOTER texto_pie_de_página opcional	El texto que se debe insertar en la parte inferior de cada página de un reporte. texto_pie_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema FOOTER de Analytics.
KEY salto_campo opcional	El campo o la expresión que agrupa los cálculos de subtotal de grupos. Se calcula un subtotal cada vez que cambia el valor de salto_campo. salto_campo debe ser un campo de caracteres o una expresión. Puede especificar un solo campo, pero puede usar una expresión que contenga más de un campo.
SUPPRESS opcional	Los valores por encima del valor MÁXIMO y por debajo del valor MÍNIMO se excluyen de la salida del comando.
COLUMNS número opcional	La longitud del eje X en la representación de texto del gráfico de barras si envía los resultados del histograma a un archivo de texto. El valor número es el número de espacios de caracteres (columnas de texto) que se deben utilizar para el eje X (y las etiquetas del eje Y). Si omite COLUMNS, se utiliza el valor predeterminado de 78 espacios de caracteres.
APPEND opcional	Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo. Nota Debe asegurarse de que la estructura de la salida del comando y del archivo existente sean idénticas: los mismos campos el mismo orden de campos los campos coincidentes son de la misma longitud los campos coincidentes tienen el mismo tipo de datos Analytics anexa la salida a un archivo existente sin importar cuál sea su estructura. Si la estructura de la salida y la del archivo existente no coinciden, es posible que los datos que se obtengan estén incompletos, mezclados o sean imprecisos.
OPEN opcional	Abre la tabla creada por el comando después de la ejecución del comando. Solo es válido si el comando crea una tabla de salida.

Ejemplos

Histograma básico de salario por horas

Usted utiliza HISTOGRAM para crear un gráfico que muestra la distribución de los salarios entre 0 y 100 dólares por hora:

HISTOGRAM ON Tarifa MINIMUM 0 MAXIMUM 100 TO GRAPH

Histograma con intervalos definidos para salario por horas

Continuando con el ejemplo anterior, usted utiliza HISTOGRAM para especificar los rangos del gráfico de una manera que tiene más sentido.

La mayoría de los salarios se encuentran entre 20 y 50 dólares por hora; por lo tanto, el gráfico incluye los siguientes números de intervalos:

tres en el rango de 20 a 50
uno para 0-20
uno para 50-100
uno para > 100

HISTOGRAM ON Tarifa MINIMUM 0 MAXIMUM 100 FREE 20;30;40;50;100 TO GRAPH

Observaciones

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Crear histogramas.

Rellenar los valores bajo y elevado

Puede ejecutar los comandos STATISTICS o PROFILE en un campo numérico antes de ejecutar el comando HISTOGRAM para rellenar automáticamente los valores de los parámetros MINIMUM y MAXIMUM con los valores más bajos y más elevados del campo.

Comandos relacionados

La creación de un histograma utilizando un campo de caracteres es similar a la clasificación. La creación de un histograma utilizando un campo numérico es similar a la estratificación.

A diferencia de otras operaciones de agrupamiento de Analytics, los histogramas no admiten la subtotalización de los campos numéricos.