Comando HISTOGRAM

Informações do conceito

Agrupa os registros com base em valores de um campo de caracteres ou numérico, conta o número de registros em cada grupo e exibe os grupos e contagens em um gráfico de barras.

Sintaxe

HISTOGRAM {<ON> campo_de_caractere|<ON> campo_numérico MINIMUM valor MAXIMUM valor {<INTERVALS número>|FREE valor_intervalo <...n> último_intervalo}} <TO {SCREEN|nome_arquivo|GRAPH|PRINT}> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <HEADER texto_cabeçalho> <FOOTER texto_cabeçalho> <KEY campo_divisão> <SUPPRESS> <COLUMNS número> <APPEND> <OPEN>

Parâmetros

Nome	Descrição
ON campo_de_caractere	O campo ou expressão de caracteres a ser utilizado no histograma.
ON campo_numérico	O campo ou expressão numérica a ser utilizado no histograma.
MINIMUM valor	Aplica-se somente a campos numéricos. O valor mínimo do primeiro intervalo numérico. MINIMUM será opcional se você usar FREE. Caso contrário, será obrigatório.
MAXIMUM valor	Aplica-se somente a campos numéricos. O valor máximo do último intervalo numérico. MAXIMUM será opcional se você usar FREE. Caso contrário, será obrigatório.
INTERVALS número opcional	Aplica-se somente a campos numéricos. A quantidade de intervalos de tamanhos iguais que o Analytics deve produzir na faixa especificada pelos valores MINIMUM e MAXIMUM. Se a quantidade de intervalos não for especificada, uma quantidade padrão é utilizada. O padrão é especificado pelo número Intervalos na guia Comando na caixa de diálogo Opções.
FREE valor_do_intervalo <...n> último_intervalo opcional	Aplica-se somente a campos numéricos. Cria intervalos de tamanho personalizado, especificando o ponto inicial de cada intervalo e o ponto final do último intervalo. Se os valores MINIMUM e MAXIMUM forem especificados, eles serão o ponto inicial do primeiro intervalo e o ponto final do último intervalo, e cada valor_intervalo criará um novo intervalo nesta faixa. Os valores de intervalo especificados devem ser maiores que o valor MINIMUM e iguais ou menores que o valor MAXIMUM. Os valores do intervalo devem estar em sequência numérica e não podem conter valores duplicados: FREE -1000, 0, 1000, 2000, 3000 Se você especificar FREE e INTERVALS, INTERVALS será ignorado.
TO SCREEN \| nome_arquivo \| GRAPH \| PRINT	A localização para onde enviar os resultados do comando: A TELA exibe os resultados na área de exibição do Analytics Dica Você pode clicar em qualquer valor de resultado vinculado na área de exibição para detalhar até o registro ou os registros associados na tabela de origem. nome_arquivo salva os resultados em um arquivo Especifique nome_arquivo como uma cadeia entre aspas com uma extensão de arquivo apropriada. Por exemplo: TO "Saída.TXT" Por padrão, o arquivo é salvo na pasta que contém o projeto do Analytics. Use um caminho de arquivo absoluto ou relativo para salvar o arquivo em uma pasta diferente já existente: TO "C:\Saída.TXT" TO "Resultados\Saída.TXT" GRAPH exibe os resultados em um gráfico na área de exibição do Analytics PRINT envia os resultados para a impressora padrão Nota Os resultados do histograma enviados a um arquivo são uma representação em texto de um gráfico de barras.
IF teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição. Nota O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).
WHILE teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado. Nota Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.
FIRST intervalo \| NEXT intervalo opcional	O número de registros a ser processado: FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado Use intervalo para especificar o número de registros a serem processados. Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.
HEADER texto_cabeçalho opcional	O texto a ser inserido na parte superior de cada página de um relatório. texto_cabeçalho deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema HEADER do Analytics.
FOOTER texto_rodapé opcional	O texto a ser inserido na parte inferior de cada página de um relatório. texto_rodapé deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema FOOTER do Analytics.
KEY campo_quebra opcional	O campo ou expressão que agrupa cálculos de subtotal. Um subtotal é calculado cada vez que o valor de campo_quebra muda. campo_quebra deve ser um campo ou expressão de caracteres. Apenas um campo pode ser especificado, mas é possível usar uma expressão que contém mais que um campo.
SUPPRESS opcional	Valores maiores que MAXIMUM e menores que MINIMUM devem ser excluídos da saída do comando.
COLUMNS número opcional	O comprimento do eixo x na representação textual do gráfico de barras se você gerar os resultados do histograma em um arquivo de texto. O valor número é o número de espaços de caractere (colunas de texto) usado para o eixo x (e os rótulos do eixo y). Se COLUMNS for omitido, o padrão de 78 espaços de caractere será usado.
APPEND opcional	Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo. Nota Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos: os mesmos campos a mesma ordem de campos os campos correspondentes têm o mesmo comprimento os campos correspondentes têm o mesmo tipo de dados O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.
OPEN opcional	Abre a tabela criada pelo comando após a execução do comando. Válido apenas se o comando criar uma tabela de saída.

Exemplos

Histograma básico para salário por hora

Use HISTOGRAM para criar um gráfico mostrando a distribuição dos salários entre 0 e 100 dólares por hora:

HISTOGRAM ON Taxa MINIMUM 0 MAXIMUM 100 TO GRAPH

Histograma com intervalos definidos por salário por hora

Continuando o exemplo anterior, use HISTOGRAM para especificar os intervalos no gráfico de maneira mais significativa.

A maioria dos salários se situa entre 20 e 50 dólares por hora. Portanto, portanto o gráfico inclui a seguinte distribuição de intervalos:

três no intervalo de 20 a 50
um para 0 a 20
um para 50 a 100
um para maior que 100

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

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Criar histogramas.

Preenchimento de valores baixos e altos

Os comandos STATISTICS e PROFILE podem ser executados em um campo numérico antes da execução do comando HISTOGRAM para popular automaticamente os valores dos parâmetros MINIMUM e MAXIMUM com os valores mínimo e máximo do campo.

Comandos relacionados

Criar um histograma usando um campo de caracteres é similar a classificar. Criar um histograma usando um campo numérico é similar a estratificar.

Diferentemente de outras operações de agrupamento do Analytics, os histogramas não oferecem suporte à subtotalização de campos numéricos.