Comando CVSPREPARE

Informações do conceito

Preparação de uma amostra clássica de variáveis

Estratifica uma população e calcula um tamanho de amostra estatisticamente válido para cada estrato na amostragem clássica de variáveis.

Sintaxe

CVSPREPARE ON campo_valor_contábil NUMSTRATA número MINIMUM tamanho_mínimo_amostra_estrato PRECISION valor CONFIDENCE nível_de_confiabilidade <CUTOFF valor> <BCUTOFF valor> NCELLS número PLIMIT {BOTH|UPPER|LOWER} ERRORLIMIT número <IF teste> <MINSAMPSIZE tamanho_mínimo_amostra> TO {SCREEN|nome_arquivo}

Parâmetros

Nota

Não inclua separadores de milhares ou símbolos de porcentagem ao especificar valores.

Nome	Descrição
ON campo_valor_contábil	O campo numérico de valor contábil a ser utilizado como base para preparar a amostra clássica de variáveis.
NUMSTRATA número	O número de estratos a ser usado para estratificar numericamente o campo_valor_contábil. O número mínimo de estratos é 1 e o máximo é 256. Se você especificar NUMSTRATA 1 e não especificar um CUTOFF, a população será desestratificada antes da obtenção de uma amostra. Nota O número de estratos não pode exceder 50% do número de células especificado para NCELLS.
MINIMUM tamanho_mínimo_amostra_estrato	O número mínimo de registros a ser amostrado de cada estrato. Deixe o valor padrão 0 (zero) se não tiver um motivo específico para definir um número mínimo.
PRECISION valor	O valor monetário que é a diferença entre a afirmação incorreta permitida e a afirmação incorreta esperada na conta. Afirmação incorreta permitida o valor total máximo de afirmação incorreta que pode ocorrer no campo de amostra sem que a afirmação incorreta seja considerada relevante Afirmação incorreta esperada o valor total de afirmações incorretas esperado no campo de amostra A precisão estabelece o intervalo de aceitação para que uma conta seja considerada declarada corretamente. A redução da precisão diminui o intervalo de aceitação (a margem de erro), o que exige um maior tamanho da amostra.
CONFIDENCE nível_de_confiabilidade	O nível de confiabilidade desejado de que a amostra resultante será representativa de toda a população. Por exemplo, 95 significa que você quer ter confiança de que 95% das vezes a amostra será realmente representativa. A confiabilidade é o complemento do "risco de amostragem". Um nível de confiabilidade de 95% é o mesmo que um risco de amostragem de 5%. Se PLIMIT for BOTH, o nível mínimo de confiabilidade será 10% e o máximo 99,5%. Se PLIMIT for UPPER ou LOWER, o nível mínimo de confiabilidade será 55% e o máximo 99,5%.
CUTOFF valor opcional	Um valor de limite do estrato de certeza superior. Valores de campo_valor_contábil maiores ou iguais ao valor do limite serão selecionados e incluídos automaticamente na amostra. Se você omitir CUTOFF, será usado um valor limite padrão igual ao valor máximo de campo_valor_contábil e nenhum registro será incluído no estrato de certeza superior.
BCUTOFF valor opcional	Um valor de limite do estrato de certeza inferior. Valores de campo_valor_contábil menores ou iguais ao valor do limite serão selecionados e incluídos automaticamente na amostra. Se você omitir BCUTOFF, será usado um valor limite padrão igual ao valor mínimo de campo_valor_contábil e nenhum registro será incluído no estrato de certeza inferior.
NCELLS número	O número de células a ser usado para pré-estratificar o campo_valor_contábil. As células são divisões numéricas mais limitadas que os estratos. A pré-estratificação é parte de um processo interno que otimiza a posição dos limites dos estratos. As células não são retidas na saída estratificada final. O número mínimo de células é 2 e o máximo é 999. Nota O número de células deve ser, pelo menos, o dobro (2x) do número de estratos especificado em NUMSTRATA.
PLIMIT BOTH \| UPPER \| LOWER	O tipo de limite de precisão a ser usado. BOTH - especifique esta opção se: a conta como um todo pode ser uma afirmação exagerada ou insuficiente você está interessado em estimar se a afirmação incorreta em qualquer direção excede a PRECISION especificada UPPER - especifique esta opção se: for provável que a conta como um todo seja uma afirmação insuficiente você somente está interessado em estimar se o valor total da afirmação insuficiente excede a PRECISION especificada LOWER - especifique esta opção se: for provável que a conta como um todo seja uma afirmação exagerada você somente está interessado em estimar se o valor total da afirmação exagerada excede a PRECISION especificadaCuidado Especifique AMBOS se não tiver certeza sobre qual opção escolher.
ERRORLIMIT número	O número mínimo de erros esperados para a amostra. Nota Se o número real de erros encontrados na análise da amostra for inferior a ERRORLIMIT número, o único método de avaliação disponível será a média por unidade.
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. Cuidado Se você especificar uma expressão condicional, uma expressão condicional idêntica deverá ser usada durante o cálculo do tamanho da amostra e a obtenção da amostra. Se você usar uma condição em uma etapa e não na outra, ou se as duas condições não forem idênticas, os resultados da amostragem provavelmente não serão estatisticamente válidos.
MINSAMPSIZE tamanho_mínimo_amostra opcional	O número mínimo de registros a ser amostrado em toda a população. Deixe o valor padrão 0 (zero) se não tiver um motivo específico para definir um número mínimo.
TO SCREEN \| nome_arquivo	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"

Variáveis de saída do Analytics

Nome	Contém
CONFIDENCE	O nível de confiabilidade especificado pelo usuário.
ERRLIMIT	O número mínimo de erros especificado pelo usuário.
NSTRATA	O número de estratos especificado pelo usuário.
PLIMIT	O tipo de limite de precisão especificado pelo usuário.
S_IF	Uma expressão condicional especificada pelo usuário
S_TOP	O valor de limite do estrato de certeza superior especificado pelo usuário. Se nenhum valor for especificado, será o limite superior do estrato superior calculado pelo comando.
SAMPLEFIELD	O campo de valor contábil especificado pelo usuário.
SBOTTOM	O valor de limite do estrato de certeza inferior especificado pelo usuário. Se nenhum valor for especificado, será o limite inferior do estrato inferior calculado pelo comando.
SBOUNDARY	Todos os limites superiores de estratos calculados pelo comando. Não inclui estratos de certeza superiores ou inferiores.
SPOPULATION	O número de registros e o valor monetário total em cada estrato. Não inclui estratos de certeza superiores ou inferiores.
SSAMPLE	O tamanho da amostra de cada estrato calculado pelo comando. Não inclui estratos de certeza superiores ou inferiores.

Exemplos

Preparar uma amostra clássica de variáveis

Você decidiu usar amostragem clássica de variáveis para estimar o valor total de afirmações incorretas monetárias em uma conta que contém faturas.

Antes de obter a amostra, você deve estratificar a população e calcular um tamanho de amostra estatisticamente válido para cada estrato.

Você quer ter confiança de que, 95% das vezes, a amostra obtida pelo Analytics será representativa da população como um todo.

Usando o seu nível de confiabilidade especificado, o exemplo abaixo estratifica uma tabela com base no campo valor_fatura e calcula o tamanho da amostra para cada estrato e o estrato de certeza superior:

CVSPREPARE ON valor_fatura NUMSTRATA 5 MINIMUM 0 PRECISION 928003,97 CONFIDENCE 95,00 CUTOFF 35000 NCELLS 50 PLIMIT BOTH ERRORLIMIT 6 MINSAMPSIZE 0 TO SCREEN

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Preparação de uma amostra clássica de variáveis.

Limitação de tamanho numérico

Vários cálculos internos ocorrem durante a fase de preparação da amostragem clássica de variáveis. Esses cálculos permitem números com um comprimento máximo de 17 dígitos. Se o resultado de qualquer cálculo exceder 17 dígitos, o resultado não será incluído na saída e você não poderá continuar com o processo de amostragem.

Os números dos dados de origem com menos de 17 dígitos podem produzir resultados de cálculos internos que excedem 17 dígitos.