ComputeModel

Geeft een JSON-object met het resultaat van een Core ML-modelevaluatie.

Opmaak 

Voor algemene modellen:

ComputeModel (modelNaam ; parameterNaam1 ; waarde1)

Voor vision-modellen:

ComputeModel (modelNaam ; "afbeelding" ; waarde1 ; "confidenceLowerLimit" ; returnAtLeastOne)

Parameters 

modelNaam - de naam van het te evalueren model. Deze waarde moet overeenkomen met de naam van een eerder geladen model.

parameterNaam1 - de naam van een invoerparameter zoals gedefinieerd door de ontwerper van het model. U moet de naam weten van elk van deze parameters voordat u het model gebruikt.

waarde1 - de waarde van een modelinvoerparameter.

afbeelding (alleen vision-modellen) - het type gegevens dat het model zal evalueren.

confidenceLowerLimit (alleen vision-modellen) (optioneel) - een gebruikte waarde die het aantal resultaten beperkt dat door vision-modellen wordt geretourneerd door resultaten uit te sluiten die lager zijn dan de opgegeven waarde. Deze waarde moet tussen 0.0 en 1.0 liggen.

returnAtLeastOne (alleen vision-modellen) - een waarde van waar (niet nul) of onwaar (nul). Als alle resultaten worden uitgesloten door de waarde van confidenceLowerLimit en:

  • als returnAtLeastOne waar is, wordt het resultaat met het hoogste vertrouwen geretourneerd
  • als returnAtLeastOne onwaar is of niet is opgegeven, wordt er een lege tekenreeks geretourneerd

Resulterend gegevenstype 

tekst

Afkomstig uit versie 

19.0

Beschrijving 

Het geretourneerde object is een matrix van naam-waarde-paren of een specifiek naam-waarde-paar, afhankelijk van de definitie van het model dat wordt geëvalueerd.

Opmerkingen 

  • Een Core ML-model moet eerst worden geladen met de Machine Learning-model configureren scriptstap voordat ComputeModel kan worden gebruikt.
  • Een invoerparameter moet worden gevolgd door de bijbehorende waarde, en er kunnen meerdere parameter-waarde-paren worden gebruikt.
  • Als een resultaat twee overeenkomsten met dezelfde vertrouwensscore bevatten, wordt alleen de eerste waarde geretourneerd.
  • Deze functie wordt alleen ondersteund in iOS, iPadOS en macOS.

Voorbeeld 1 

Aannemende dat een model met de naam MobileNet is geladen en een containerveld met de naam mijnAfbeeldingVeld deel uitmaakt van de huidige lay-out (of anderszins beschikbaar is voor de berekening):

ComputeModel ("MobileNet"; "afbeelding"; mijnAfbeeldingVeld)

evalueert de afbeelding in mijnAfbeeldingVeld met behulp van het opgegeven model en retourneert de volgende JSON-tekenreeks (opgemaakt en regels weggelaten voor betere leesbaarheid):

Kopiëren
[
    {
        "classificatie" : "vleugelpiano, vleugel",
        "vertrouwen" : 0.998073041439056
    },
    {
        "classificatie" : "staande, staande piano",
        "vertrouwen" : 0.00192673446144909
    },
    {
        "classificatie" : "pooltafel, biljarttafel, snookertafel",
        "vertrouwen" : 8.34678601790984e-08
    },
    {
        "classificatie" : "eettafel, bijzettafel",
        "vertrouwen" : 2.60599577472931e-08
    },
    {
        "classificatie" : "tropische vis, kogelvis, blaasvis, pufferfish",
        "vertrouwen" : 5.19516656696278e-18
    }
]

Voorbeeld 2 

Door gebruik te maken van hetzelfde model, containerveld en de afbeelding uit Voorbeeld 1, geeft de volgende berekening:

ComputeModel("MobileNet"; "afbeelding"; mijnAfbeeldingVeld; "confidenceLowerLimit"; 1.0; "returnAtLeastOne"; 1)

deze JSON-tekenreeks als resultaat:

Kopiëren
[
    {
        "classificatie" : "vleugelpiano, vleugel",
        "vertrouwen" : 0.998073041439056
    }
]

Door een waarde van 1.0 door te geven aan confidenceLowerLimit worden alle resultaten uitgesloten. Maar omdat returnAtLeastOne is ingesteld op een andere waarde dan nul, wordt het resultaat met de hoogste vertrouwensscore geretourneerd.