ImageClassifier

Klasifikuesi i imazhit të klasës përfundimtare publike

Kryen klasifikimin në imazhe.

API pret një model TFLite me metadata të modelit TFLite opsionale, por shumë të rekomanduara. .

API mbështet modele me një tensor hyrjeje imazhi dhe një ose më shumë tensorë dalës. Për të qenë më specifik, këtu janë kërkesat.

  • Tenzori hyrës i imazhit ( kTfLiteUInt8 / kTfLiteFloat32 )
    • futja e imazhit të madhësisë [batch x height x width x channels] .
    • konkluzioni i grupit nuk mbështetet (kërkohet që batch të jetë 1).
    • mbështeten vetëm hyrjet RGB ( channels duhet të jenë 3).
    • nëse lloji është kTfLiteFloat32, NormalizationOptions kërkohet t'i bashkëngjiten meta të dhënave për normalizimin e hyrjes.
  • Të paktën një tensor dalës ( kTfLiteUInt8 / kTfLiteFloat32 ) me:
    • N klasa dhe 2 ose 4 dimensione, p.sh. [1 x N] ose [1 x 1 x 1 x N]
    • Hartat e etiketës opsionale (por të rekomanduara) si AssociatedFile-s me llojin TENSOR_AXIS_LABELS, që përmbajnë një etiketë për rresht. I pari i tillë AssociatedFile (nëse ka) përdoret për të mbushur fushën class_name të rezultateve. Fusha display_name plotësohet nga AssociatedFile (nëse ka) vendndodhja e së cilës përputhet me fushën display_names_locale të ImageClassifierOptions të përdorura në kohën e krijimit ("en" si parazgjedhje, p.sh. anglisht). Nëse asnjëra nga këto nuk është e disponueshme, do të plotësohet vetëm fusha e index të rezultateve.
    • Kalibrimi opsional i rezultateve mund të bashkëngjitet duke përdorur ScoreCalibrationOptions dhe një AssociatedFile me llojin TENSOR_AXIS_SCORE_CALIBRATION. Shikoni metadata_schema.fbs për më shumë detaje.

Një shembull i një modeli të tillë mund të gjendet TensorFlow Hub .

Klasat e mbivendosura

klasës ImageClassifier.ImageClassifierOptions Opsionet për konfigurimin dhe ImageClassifier .

Metodat publike

ImageClassifierRezultati
klasifiko (imazh MPI )
Kryen klasifikimin në imazhin e vetëm të dhënë me opsionet e paracaktuara të përpunimit të imazhit, dmth
ImageClassifierRezultati
klasifiko (imazh MPIimage , ImageProcessingOptions imageProcessingOptions)
Kryen klasifikimin në imazhin e vetëm të dhënë.
i pavlefshëm
classifyAsync (imazh MPImage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohore)
Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer klasifikimin dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ImageClassifier.ImageClassifierOptions .
i pavlefshëm
classifyAsync (imazh i imazhit MPI , vula kohore të gjata)
Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer klasifikimin me opsionet e paracaktuara të përpunimit të imazhit, dmth
ImageClassifierRezultati
classifyForVideo (imazh MPI-imazhi , vula kohore të gjata)
Kryen klasifikimin në kornizën e dhënë të videos me opsionet e paracaktuara të përpunimit të imazhit, dmth
ImageClassifierRezultati
klasifikojPërVideo (imazh MPIimage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohoreM)
Kryen klasifikimin në kornizën e dhënë të videos.
Klasifikuesi i imazhit statik
createFromBuffer (konteksti i kontekstit, ByteBuffer modelBuffer)
Krijon një shembull ImageClassifier nga një tampon modeli dhe parazgjedhja ImageClassifier.ImageClassifierOptions .
Klasifikuesi i imazhit statik
createFromFile (konteksti i kontekstit, modeli i vargut shteg)
Krijon një shembull ImageClassifier nga një skedar modeli dhe ImageClassifier.ImageClassifierOptions të parazgjedhur.
Klasifikuesi i imazhit statik
createFromFile (konteksti i kontekstit, modeli i skedaritFile )
Krijon një shembull ImageClassifier nga një skedar modeli dhe ImageClassifier.ImageClassifierOptions të parazgjedhur.
Klasifikuesi i imazhit statik
createFromOptions (konteksti i kontekstit, opsionet ImageClassifier.ImageClassifierOptions )
Krijon një shembull ImageClassifier nga një shembull ImageClassifier.ImageClassifierOptions .

Metodat e trashëguara

Metodat publike

Klasifikimi i imazhit publik Klasifikimi i rezultateve (imazhi i imazhit MPI )

Kryen klasifikimin në imazhin e vetëm të dhënë me opsionet e përpunimit të paracaktuar të imazhit, dmth duke përdorur të gjithë imazhin si rajon me interes dhe pa asnjë rrotullim të aplikuar. Përdoreni këtë metodë vetëm kur ImageClassifier është krijuar me ERROR(/RunningMode.IMAGE) .

ImageClassifier mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
Hedhjet
nëse ka një gabim të brendshëm.

Klasifikimi publik i ImageClassifierRezultati (imazhi MPImage , ImageProcessingOptions imageProcessingOptions)

Kryen klasifikimin në imazhin e vetëm të dhënë. Përdoreni këtë metodë vetëm kur ImageClassifier është krijuar me ERROR(/RunningMode.IMAGE) .

ImageClassifier mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
imageProcessingOptions ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi.
Hedhjet
nëse ka një gabim të brendshëm.

publik void classifyAsync (imazh MPIimage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohore)

Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer klasifikimin dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ImageClassifier.ImageClassifierOptions . Përdoreni këtë metodë vetëm kur ImageClassifier është krijuar me ERROR(/RunningMode.LIVE_STREAM) .

Kërkohet të jepet një vulë kohore (në milisekonda) për të treguar se kur imazhi i hyrjes dërgohet në detektorin e objektit. Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ImageClassifier mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
imageProcessingOptions ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
nëse ka një gabim të brendshëm.

publik void classifyAsync (imazhi i imazhit MPI , stampat e gjata kohore)

Dërgon të dhënat e imazheve të drejtpërdrejta për të kryer klasifikimin me opsionet e përpunimit të imazhit të paracaktuar, p.sh. duke përdorur të gjithë imazhin si rajon me interes dhe pa asnjë rrotullim të aplikuar, dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ImageClassifier.ImageClassifierOptions . Përdoreni këtë metodë vetëm kur ImageClassifier është krijuar me ERROR(/RunningMode.LIVE_STREAM) .

Kërkohet të jepet një vulë kohore (në milisekonda) për të treguar se kur imazhi i hyrjes dërgohet në detektorin e objektit. Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ImageClassifier mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
nëse ka një gabim të brendshëm.

Klasifikimi i imazhit publik Klasifikimi i rezultateve PërVideo (Imazhi MPI , vula kohore të gjata)

Kryen klasifikimin në kornizën e dhënë të videos me opsionet e përpunimit të paracaktuar të imazhit, dmth duke përdorur të gjithë imazhin si rajon me interes dhe pa asnjë rrotullim të aplikuar. Përdoreni këtë metodë vetëm kur krijohet ImageClassifier me ERROR(/RunningMode.VIDEO) .

Kërkohet të jepet vula kohore e kornizës së videos (në milisekonda). Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ImageClassifier mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
nëse ka një gabim të brendshëm.

Klasifikuesi i imazhit publik Klasifikimi i rezultateve PërVideo (imazhi i imazhit MPI , Opsionet e imazhit të procesimit të opsioneve të procesit të imazhit , vulat kohore të gjata)

Kryen klasifikimin në kornizën e dhënë të videos. Përdoreni këtë metodë vetëm kur krijohet ImageClassifier me ERROR(/RunningMode.VIDEO) .

Kërkohet të jepet vula kohore e kornizës së videos (në milisekonda). Vula kohore e hyrjes duhet të rritet në mënyrë monotone.

ImageClassifier mbështet llojet e mëposhtme të hapësirës së ngjyrave:

Parametrat
imazh një objekt MediaPipe MPImage për përpunim.
imageProcessingOptions ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi.
vula kohoreMs vulën kohore të hyrjes (në milisekonda).
Hedhjet
nëse ka një gabim të brendshëm.

ImageClassifier publik statik i krijuar nga Buffer (konteksti i kontekstit, modeli ByteBuffer )

Krijon një shembull ImageClassifier nga një tampon modeli dhe parazgjedhja ImageClassifier.ImageClassifierOptions .

Parametrat
kontekst një ERROR(/Context) në Android.
modelBuffer një ByteBuffer direkt ose një ERROR(/MappedByteBuffer) i modelit të klasifikimit.
Hedhjet
nëse ka një gabim gjatë krijimit të ImageClassifier .

ImageClassifier publik statik i krijuar nga skedari (konteksti i kontekstit, modeli i vargut Path)

Krijon një shembull ImageClassifier nga një skedar modeli dhe ImageClassifier.ImageClassifierOptions të parazgjedhur.

Parametrat
kontekst një ERROR(/Context) në Android.
modelRruga rrugën drejt modelit të klasifikimit në aktive.
Hedhjet
nëse ka një gabim gjatë krijimit të ImageClassifier .

Klasifikuesi i imazhit statik publik i krijuar nga skedari (konteksti i kontekstit, modeli i skedaritFile )

Krijon një shembull ImageClassifier nga një skedar modeli dhe ImageClassifier.ImageClassifierOptions të parazgjedhur.

Parametrat
kontekst një ERROR(/Context) në Android.
modelFile modeli i klasifikimit File skedarit.
Hedhjet
Përjashtim IO nëse ndodh një gabim I/O kur hapet skedari i modelit tflite.
nëse ka një gabim gjatë krijimit të ImageClassifier .

publike statike ImageClassifier createFromOptions (konteksti i kontekstit, Opsionet ImageClassifier.ImageClassifierOptions )

Krijon një shembull ImageClassifier nga një shembull ImageClassifier.ImageClassifierOptions .

Parametrat
kontekst një ERROR(/Context) në Android.
opsionet një shembull ImageClassifier.ImageClassifierOptions .
Hedhjet
nëse ka një gabim gjatë krijimit të ImageClassifier .