ComputeModel

Retorna um objeto JSON que contém o resultado da avaliação do modelo Core ML.

Formato 

Para modelos gerais:

ComputeModel ( NomeDoModelo ; NomeDoParâmetro1 ; valor1 )

Para modelos de visão:

ComputeModel ( NomeDoModelo ; "imagem" ; valor1 ; "confiançaLimiteInferior" ; retornarNoMínimoUm )

Parâmetros 

NomeDoModelo - o nome do modelo a ser avaliado. Esse valor deve corresponder ao nome de um modelo carregado anteriormente.

NomeDoParâmetro1 - o nome de um parâmetro de entrada, conforme definido pelo criador do modelo. Antes de usar o modelo, você deve saber o nome de cada um desses parâmetros.

valor1 - o valor de um parâmetro de entrada do modelo.

imagem (somente modelos de visão) - o tipo de dados que o modelo avaliará.

confiançaLimiteInferior (somente modelos de visão) (opcional) - um valor usado para limitar o número de resultados retornados pelos modelos de visão por meio da exclusão de resultados inferiores ao valor especificado. Esse valor deve estar entre 0,0 e 1,0.

retornarNoMínimoUm (somente modelos de visão) - um valor verdadeiro (diferente de zero) ou falso (zero). Se todos os resultados forem excluídos pelo valor do confiançaLimiteInferior e:

  • se retornarNoMínimoUm for true, o resultado com a maior confiança será retornado
  • se retornarNoMínimoUm for false ou not specified, será retornada uma sequência vazia

Tipo de dados retornado 

texto

Originada na versão 

19.0

Descrição 

O objeto retornado é uma matriz de pares nome-valor ou um único par nome-valor, dependendo da definição do modelo avaliado.

Notas 

  • Um modelo Core ML deve ser carregado primeiro com a Etapa de script Configurar o modelo Machine Learning antes que o ComputeModel possa ser usado.
  • Um parâmetro de entrada deve ser seguido por seu respectivo valor, e vários pares de parâmetro-valor de entrada podem ser usados.
  • Se um resultado contiver duas correspondências com a mesma confiança, somente o primeiro valor será retornado.
  • Essa função é compatível apenas com iOS, iPadOS e macOS.

Exemplo 1 

Supondo que um modelo chamado MobileNet tenha sido carregado e um campo do container chamado meuCampoDeImagem está no layout atual (ou disponível para o cálculo):

ComputeModel ( "MobileNet"; "imagem"; meuCampoDeImagem )

avalia a imagem em meuCampoDeImagem usando o modelo fornecido e retorna a seguinte string JSON (formatada para clareza com algumas linhas removidas para brevidade):

Copiar 
[
    {
        "classificação" : "piano de cauda, cauda",
        "confiança" : 0.998073041439056
    },
    {
        "classificação" : "vertical, piano vertical",
        "confiança" : 0.00192673446144909
    },
    {
        "classificação" : "mesa de sinuca, mesa de bilhar, mesa de snooker",
        "confiança" : 8.34678601790984e-08
    },
    {
        "classificação" : "mesa de jantar, mesa",
        "confiança" : 2.60599577472931e-08
    },
    {
        "classificação" : "baiacu, peixe baiacu, peixe-balão, peixe fugu",
        "confiança" : 5.19516656696278e-18
    }
]

Exemplo 2 

Usando o mesmo modelo, campo de container e imagem do Exemplo 1, o seguinte cálculo:

ComputeModel ( "MobileNet"; "imagem"; meuCampoDeImagem; "confiançaLimiteInferior"; 1.0; "retornarNoMínimoUm"; 1 )

retorna a sequência JSON:

Copiar 
[
    {
        "classificação" : "piano de cauda, cauda",
        "confiança" : 0.998073041439056
    }
]

O confiançaLimiteInferior de aprovação com valor de 1.0 exclui todos os resultados. No entanto, como retornarNoMínimoUm é definido como valor diferente de zero, o resultado com a maior confiança é retornado.

Tópicos relacionados