Comando CVSSAMPLE

Obtém uma amostra de registros usando o método de amostragem clássica de variáveis.

Sintaxe

CVSSAMPLE ON campo_valor_contábil NUMSTRATA número <SEED valor_de_origem> CUTOFF valor <BCUTOFF valor> STRATA valor_limite <,...n> SAMPLESIZE número <,...n> POPULATION número_estratos,valor_estrato <,...n> <IF teste> TO nome_tabela

Parâmetros

Nota

Se você estiver usando os resultados de saída do comando CVSPREPARE como entrada para o comando CVSSAMPLE, vários valores de parâmetro já estarão sendo especificados e armazenados em variáveis. Para obter mais informações, consulte Comando CVSPREPARE.

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 a amostra.
NUMSTRATA número O número de estratos a ser usado para estratificar o campo_valor_contábil.
SEED valor_de_origem

opcional

O valor de origem usado para inicializar o gerador de números aleatórios no Analytics.

Se você omitir SEED, o Analytics selecionará aleatoriamente o valor de origem.

CUTOFF valor

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.

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.

STRATA valor_limite <;...n> Os valores de limites superiores para uso na estratificação do campo_valor_contábil.
SAMPLESIZE número <;...n> O número de registros a ser amostrado de cada estrato.
POPULATION número_estratos; valor_estrato <;...n> O número de registros em cada estrato e o valor total de cada estrato.
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.

TO nome_tabela

A localização para onde enviar os resultados do comando:

  • nome_tabela salva os resultados em uma tabela do Analytics

    Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL"

    Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics.

    Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente:

    • TO "C:\Saída.FIL"
    • TO "Resultados\Saída.FIL"

    Nota

    Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

Variáveis de saída do Analytics

Nome Contém
S_TOPEV

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 previamente pelo comando CVSPREPARE.

Além disso, armazena o número de registros do estrato de certeza superior e seu valor monetário total.

SBOTTOMEV

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 previamente pelo comando CVSPREPARE.

Além disso, armazena o número de registros do estrato de certeza inferior e seu valor monetário total.

SBOUNDARYEV Todos os limites inferiores de estratos preenchidos previamente pelo comando ou especificados pelo usuário. 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.

Exemplos

Obter uma amostra clássica de variáveis

Você vai 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.

Após estratificar a população e calcular um tamanho de amostra estatisticamente válido para cada estrato, você está pronto para obter a amostra.

O exemplo abaixo obtém uma amostra estratificada de registros de acordo com o campo valor_fatura e grava os registros amostrados na tabela Amostra_faturas:

CVSSAMPLE ON valor_fatura NUMSTRATA 5 SEED 12345 CUTOFF 35000,00 STRATA 4376,88;9248,74;16904,52;23864,32;35000,00 SAMPLESIZE 37;36;49;36;39 POPULATION 1279;3382131,93;898;5693215,11;763;9987014,57;627;12657163,59;479;13346354,63 TO "Amostra_faturas"

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Execução da amostragem clássica de variáveis.

Campos gerados pelo sistema

O Analytics gera automaticamente quatro campos e os adiciona à tabela de saída da amostra. Para cada registro incluído na amostra, o campo contém as seguintes informações descritivas:

  • STRATUM o número do estrato ao qual o registro é alocado
  • ORIGIN_RECORD_NUMBER o número do registro original na tabela de dados de origem
  • SELECTION_ORDER a ordem em que o registro foi selecionado aleatoriamente, por estrato
  • SAMPLE_RECORD_NUMBER o número do registro na tabela de saída da amostra