Criar um request de visão CoreML (coreml.new_vision_request)

Declaração

objeto_request_de_visão, mensagem_de_erro = coreml.new_vision_request(caminho_do_modelo_compilado)

ou

objeto_request_de_visão, mensagem_de_erro = coreml.new_vision_request({
    compiled_model_path = caminho_do_modelo_compilado,
    uses_cpu_only = usar_apenas_CPU,
    compute_units = configuração_das_unidades_de_cálculo,
    image_crop_and_scale_option = modo_de_recorte_e_escala,
})

Parâmetros

• caminho do modelo compilado
  Texto; atualmente são compatíveis modelos de classificação de imagens e de detecção de objetos.

• uses_cpu_only
  Booleano opcional que define se a inferência deve usar somente a CPU por padrão; o padrão é false.

• compute_units Texto opcional, com efeito no iOS 12+. Aceita os seguintes valores:

  • "all"
  • "cpu_only" ou "cpu"
  • "cpu_and_gpu" ou "gpu"
  • "cpu_and_neural_engine", "ane" ou "neural_engine" (iOS 16+)

• image_crop_and_scale_option
  Inteiro opcional que define o modo de recorte e escala durante a inferência visual.

Valores retornados

• objeto do request de visão
  O objeto do request de visão; retorna nil se a criação falhar.

• mensagem de erro
  Texto; retorna nil quando a criação é bem-sucedida e a mensagem de erro quando falha.

Observações

• Disponível a partir da versão 1.3.8 do software
• Sistemas anteriores ao iOS 13 não são compatíveis.
• Esta função carrega um modelo .mlmodelc já compilado e retorna um contexto para inferência de imagens.
• É adequada para modelos visuais CoreML que recebem uma imagem como entrada.
• Se a entrada do modelo for uma feature genérica image / MLMultiArray, considere usar coreml.new_model_request.
• Além de :predict() / :run(), este objeto também oferece métodos de consulta como :results(), :is_done(), :compute_units(), :image_crop_and_scale_option() e :class_labels().

Exemplo

Consulte Inferir uma imagem usando um request de visão CoreML.