Comando CVSPREPARE

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> NCELLS número PLIMIT {BOTH|UPPER|LOWER} ERRORLIMIT número <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 determinado valor de limite do estrato de certeza. 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.
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 especificada Cuidado 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.
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: SCREEN exibe os resultados na área de exibição do Analytics 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_TOP	O valor limite do estrato de certeza 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 limite inferior do estrato inferior calculado pelo comando.
SBOUNDARY	Todos os limites superiores de estratos calculados pelo comando e S_TOP. Não armazena SBOTTOM.
SPOPULATION	O número de registros e o valor monetário total em cada estrato. Exclui itens acima do limite do estrato de certeza.
SSAMPLE	O tamanho da amostra de cada estrato calculado pelo comando.

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:

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

Nota

Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.

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.

[ Voltar ao início ]

Guia de scripting do ACL 14.1