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):
[
{
"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:
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.