Read OCR Docker-containers installeren

Met containers kunt u de Computer Vision-API's uitvoeren in uw eigen omgeving. Containers zijn ideaal voor specifieke vereisten voor beveiliging en gegevensbeheer. In dit artikel leert u hoe u uw containers kunt downloaden, installeren Computer Vision uitvoeren.

Met de Read OCR-container kunt u gedrukte en handgeschreven tekst extraheren uit afbeeldingen en documenten met ondersteuning voor JPEG-, PNG-, BMP-, PDF- en TIFF-bestandsindelingen. Zie de handleiding voor de Read API voor meer informatie.

Nieuw

Voor bestaande gebruikers van de Read-containers is een nieuwe versie van de Read-container beschikbaar met ondersteuning voor 122 talen en algemene prestatie- en 3.2-model-2021-09-30-preview AI-verbeteringen. Volg de downloadinstructies om aan de slag te gaan.

Read 3.2-container

De Read 3.2 OCR-container biedt:

• Nieuwe modellen voor verbeterde nauwkeurigheid.
• Ondersteuning voor meerdere talen binnen hetzelfde document.
• Ondersteuning voor in totaal 73 talen. Zie de volledige lijst met door OCR ondersteunde talen.
• Eén bewerking voor zowel documenten als afbeeldingen.
• Ondersteuning voor grotere documenten en afbeeldingen.
• Betrouwbaarheidsscores.
• Ondersteuning voor documenten met zowel afdruk- als handgeschreven tekst.
• Mogelijkheid om tekst te extraheren uit alleen geselecteerde pagina('s) in een document.
• Kies de uitvoerorder voor tekstregel van standaard naar een natuurlijkere leesorde voor alleen Latijnse talen.
• Tekstregelclassificatie als handgeschreven stijl of niet alleen voor Latijnse talen.

Als u momenteel Read 2.0-containers gebruikt, bekijkt u de migratiehandleiding voor meer informatie over wijzigingen in de nieuwe versies.

Vereisten

U moet voldoen aan de volgende vereisten voordat u de containers gebruikt:

Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.

Goedkeuring aanvragen om de container uit te voeren

Vul het aanvraagformulier in en verzend het om goedkeuring aan te vragen voor het uitvoeren van de container.

Het formulier vraagt informatie over u, uw bedrijf en het gebruikers scenario waarvoor u de container gaat gebruiken. Nadat u het formulier hebt verzonden, wordt het door het Azure Cognitive Services-team gecontroleerd en een e-mail bericht met een beslissing verzonden.

Nadat u bent goedgekeurd, kunt u de container uitvoeren nadat u deze hebt gedownload via de micro soft-Container Registry (MCR), die verderop in dit artikel wordt beschreven.

U kunt de container niet uitvoeren als uw Azure-abonnement niet is goedgekeurd.

Vereiste parameters verzamelen

Er zijn drie primaire para meters voor alle vereiste containers van Cognitive Services. De gebruiksrecht overeenkomst (EULA) moet aanwezig zijn met een waarde van accept . Bovendien zijn er een eindpunt-URL en API-sleutel nodig.

Eind punt-URI {ENDPOINT_URI}

De URI-waarde van het eind punt is beschikbaar op de pagina overzicht van Azure portal van de bijbehorende cognitieve service resource. Ga naar de overzichts pagina, beweeg de muis aanwijzer over het eind punt en er Copy to clipboard wordt een pictogram weer gegeven. Kopieer en gebruik waar nodig.

Subknooppuntsleutels {API_KEY}

Deze sleutel wordt gebruikt om de container te starten en is beschikbaar op de pagina sleutels van de Azure Portal van de bijbehorende cognitieve service resource. Ga naar de pagina sleutels en klik op het Copy to clipboard pictogram.

De hostcomputer

De host is een op x64 gebaseerde computer waarop de docker-container wordt uitgevoerd. Dit kan een computer in uw locatie zijn of een docker-hosting service in azure, zoals:

• Azure Kubernetes-service.
• Azure container instances.
• Een Kubernetes -cluster is geïmplementeerd op Azure stack. Zie Deploy Kubernetes to Azure stackvoor meer informatie.

Ondersteuning voor Geavanceerde vectorextensie

De hostcomputer is de computer met de Docker-container. De host moet AVX2 (Advanced Vector Extensions) ondersteunen. U kunt controleren op AVX2-ondersteuning op Linux-hosts met de volgende opdracht:

grep -q avx2 /proc/cpuinfo && echo AVX2 supported || echo No AVX2 support detected

Vereisten en aanbevelingen voor containers

In de volgende tabel wordt de minimale en aanbevolen toewijzing van resources voor elke Read OCR-container beschreven.

• Elke kern moet ten minste 2,6 gigahertz (GHz) of sneller zijn.

De kern en het geheugen komen overeen --cpus met de instellingen en , die worden gebruikt als onderdeel van de opdracht --memory docker run .

De containerafbeelding met docker pull

Container-afbeeldingen voor Lezen zijn beschikbaar.

Gebruik de docker pull opdracht om een containerafbeelding te downloaden.

Docker pull voor de Read OCR-container

Voor de meest recente preview:

docker pull mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2021-09-30-preview

docker pull mcr.microsoft.com/azure-cognitive-services/vision/read:3.2

docker pull mcr.microsoft.com/azure-cognitive-services/vision/read:2.0-preview

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

De container gebruiken

Zodra de container zich op de hostcomputer heeft,gebruikt u het volgende proces om met de container te werken.

1. Voer de container uitmet de vereiste factureringsinstellingen. Meer voorbeelden van de docker run opdracht zijn beschikbaar.
2. Een query uitvoeren op het voorspellings-eindpunt van de container.

De container uitvoeren met docker run

Gebruik de opdracht docker run om de container uit te voeren. Raadpleeg Het verzamelen van vereiste parameters voor meer informatie over het op halen van de waarden en {ENDPOINT_URI} {API_KEY} .

Voorbeelden van de docker run opdracht zijn beschikbaar.

Vervang voor de meest recente preview het pad 3.2 door:

mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2021-09-30-preview

docker run --rm -it -p 5000:5000 --memory 18g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2 \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

docker run --rm -it -p 5000:5000 --memory 18g --cpus 8 \
--env Eula=accept \
--env Billing={ENDPOINT_URI} \
--env ApiKey={API_KEY} \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:2.0-preview \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
--env Eula=accept \
--env Billing={ENDPOINT_URI} \
--env ApiKey={API_KEY} \
mcr.microsoft.com/azure-cognitive-services/vision/read:2.0-preview

Meer voorbeelden van de docker run opdracht zijn beschikbaar.

Als u een hogere doorvoer nodig hebt (bijvoorbeeld bij het verwerken van bestanden met meerdere pagina's), kunt u overwegen om meerdere containers op een Kubernetes-clusterte implementeren met behulp van Azure Storage en Azure Queue.

Als u gebruik maakt van Azure Storage voor het opslaan van afbeeldingen voor verwerking, kunt u een connection string te gebruiken bij het aanroepen van de container.

U vindt uw connection string:

1. Navigeer Storage accounts op de Azure Portal en zoek uw account.
2. Klik in de linkernavigatielijst op Toegangssleutels.
3. Uw connection string bevindt zich onder Verbindingsreeks

Meerdere containers op dezelfde host uitvoeren

Als u van plan bent om meerdere containers met blootgestelde poorten uit te voeren, moet u ervoor zorgen dat elke container wordt uitgevoerd met een andere beschik bare poort. Voer bijvoorbeeld de eerste container uit op poort 5000 en de tweede container op poort 5001.

U kunt deze container en een andere Azure Cognitive Services-container die samen op de HOST wordt uitgevoerd. U kunt ook meerdere containers van hetzelfde Cognitive Services-container uitvoeren.

Controleren of een container wordt uitgevoerd

Er zijn verschillende manieren om te controleren of de container wordt uitgevoerd. Zoek het externe IP- adres en de weer gegeven poort van de betreffende container en open uw favoriete webbrowser. Gebruik de onderstaande aanvraag-Url's om te controleren of de container wordt uitgevoerd. De onderstaande voorbeeld aanvraag-Url's zijn http://localhost:5000 , maar uw specifieke container kan variëren. Houd er rekening mee dat u afhankelijk bent van het externe IP- adres van uw container en de weer gegeven poort.

Een query uitvoeren op het voorspellingseindpunt van de container

De container bevat op REST gebaseerde eindpunt-API's voor queryvoorspelling.

Voor de meest recente preview:

Gebruik hetzelfde Swagger-pad als 3.2, maar een andere poort als u al 3.2 op de 5000-poort hebt geïmplementeerd.

Asynchroon lezen

Voor de meest recente preview is alles hetzelfde als 3.2, met uitzondering van de extra "modelVersion": "2021-09-30-preview" .

 content-length: 0
 date: Fri, 04 Sep 2020 16:23:01 GMT
 operation-location: http://localhost:5000/vision/v3.2/read/operations/a527d445-8a74-4482-8cb3-c98a65ec7ef9
 server: Kestrel

{
  "status": "succeeded",
  "createdDateTime": "2021-02-04T06:32:08.2752706+00:00",
  "lastUpdatedDateTime": "2021-02-04T06:32:08.7706172+00:00",
  "analyzeResult": {
    "version": "3.2.0",
    "readResults": [
      {
        "page": 1,
        "angle": 2.1243,
        "width": 502,
        "height": 252,
        "unit": "pixel",
        "lines": [
          {
            "boundingBox": [
              58,
              42,
              314,
              59,
              311,
              123,
              56,
              121
            ],
            "text": "Tabs vs",
            "appearance": {
              "style": {
                "name": "handwriting",
                "confidence": 0.96
              }
            },
            "words": [
              {
                "boundingBox": [
                  68,
                  44,
                  225,
                  59,
                  224,
                  122,
                  66,
                  123
                ],
                "text": "Tabs",
                "confidence": 0.933
              },
              {
                "boundingBox": [
                  241,
                  61,
                  314,
                  72,
                  314,
                  123,
                  239,
                  122
                ],
                "text": "vs",
                "confidence": 0.977
              }
            ]
          },
          {
            "boundingBox": [
              286,
              171,
              415,
              165,
              417,
              197,
              287,
              201
            ],
            "text": "paces",
            "appearance": {
              "style": {
                "name": "handwriting",
                "confidence": 0.746
              }
            },
            "words": [
              {
                "boundingBox": [
                  286,
                  179,
                  404,
                  166,
                  405,
                  198,
                  290,
                  201
                ],
                "text": "paces",
                "confidence": 0.938
              }
            ]
          }
        ]
      }
    ]
  }
}

 content-length: 0
 date: Fri, 13 Sep 2019 16:23:01 GMT
 operation-location: http://localhost:5000/vision/v2.0/read/operations/a527d445-8a74-4482-8cb3-c98a65ec7ef9
 server: Kestrel

{
  "status": "Succeeded",
  "recognitionResults": [
    {
      "page": 1,
      "clockwiseOrientation": 2.42,
      "width": 502,
      "height": 252,
      "unit": "pixel",
      "lines": [
        {
          "boundingBox": [ 56, 39, 317, 50, 313, 134, 53, 123 ],
          "text": "Tabs VS",
          "words": [
            {
              "boundingBox": [ 90, 43, 243, 53, 243, 123, 94, 125 ],
              "text": "Tabs",
              "confidence": "Low"
            },
            {
              "boundingBox": [ 259, 55, 313, 62, 313, 122, 259, 123 ],
              "text": "VS"
            }
          ]
        },
        {
          "boundingBox": [ 221, 148, 417, 146, 417, 206, 227, 218 ],
          "text": "Spaces",
          "words": [
            {
              "boundingBox": [ 230, 148, 416, 141, 419, 211, 232, 218 ],
              "text": "Spaces"
            }
          ]
        }
      ]
    }
  ]
}

Synchroon lezen

U kunt de volgende bewerking gebruiken om een afbeelding synchroon te lezen.

Wanneer de afbeelding in zijn geheel wordt gelezen, retourneert de API vervolgens alleen een JSON-antwoord. De enige uitzondering hierop is als er een fout optreedt. Wanneer er een fout optreedt, wordt de volgende JSON geretourneerd:

{
    "status": "Failed"
}

Het JSON-antwoordobject heeft dezelfde objectgrafiek als de asynchrone versie. Als u een JavaScript-gebruiker bent en de veiligheid van het type wilt, kunt u TypeScript gebruiken om het JSON-antwoord te casten.

Zie hier de TypeScript-sandbox voor een voorbeeld van een gebruiksvoorbeeld en selecteer Uitvoeren om het gebruiksgemak ervan te visualiseren.

De container stoppen

Als u de container wilt afsluiten, selecteert u in de opdracht regel omgeving waar de container wordt uitgevoerd, CTRL + C.

Problemen oplossen

Als u de container hebt uitgevoerd met een uitvoer mount en logboekregistratie ingeschakeld, genereert de container logboekbestanden die handig zijn voor het oplossen van problemen die zich tijdens het starten of uitvoeren van de container voor doen.

Als u problemen hebt met het uitvoeren van een Cognitive Services-container, kunt u de diagnosecontainer van Microsoft gebruiken. Gebruik deze container om veelvoorkomende fouten in uw implementatieomgeving vast te stellen die kunnen verhinderen dat Cognitive Services-containers werken zoals verwacht.

Gebruik de volgende Docker pull-opdracht om de container op te halen:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Voer vervolgens de container uit, {ENDPOINT_URI} vervang door uw eindpunt en vervang door uw sleutel voor uw {API_KEY} resource:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

De container test op netwerkverbinding met het facturerings-eindpunt.

Billing

De Cognitive Services verzenden factureringsgegevens naar Azure met behulp van de bijbehorende resource in uw Azure-account.

Query's naar de container worden gefactureerd in de prijscategorie van de Azure-resource die wordt gebruikt voor de ApiKey parameter .

Azure Cognitive Services containers hebben geen licentie om te worden uitgevoerd zonder dat ze zijn verbonden met het meting-/facturerings-eindpunt. U moet de containers in staat stellen om te allen tijde factureringsgegevens te communiceren met het facturerings-eindpunt. Cognitive Services containers verzenden geen klantgegevens, zoals de afbeelding of tekst die wordt geanalyseerd, naar Microsoft.

Verbinding maken met Azure

Voor de container moeten de waarden van het factureringsargument worden uitgevoerd. Met deze waarden kan de container verbinding maken met het facturerings-eindpunt. De container rapporteert ongeveer elke 10 tot 15 minuten gebruik. Als de container geen verbinding maakt met Azure binnen het toegestane tijdvenster, blijft de container worden uitgevoerd, maar worden er geen query's uitgevoerd totdat het facturerings-eindpunt is hersteld. De verbinding wordt 10 keer geprobeerd op hetzelfde tijdsinterval van 10 tot 15 minuten. Als de container geen verbinding kan maken met het facturerings-eindpunt binnen de tien pogingen, stopt de container met het verwerken van aanvragen. Zie de veelgestelde Cognitive Services container voor een voorbeeld van de informatie die naar Microsoft wordt verzonden voor facturering.

Factureringsargumenten

docker run Met de opdracht wordt de container start wanneer alle drie de volgende opties zijn opgegeven met geldige waarden:

Zie Containers configureren voor meer informatie over deze opties.

Samenvatting

In dit artikel hebt u concepten en werkstromen geleerd voor het downloaden, installeren en uitvoeren van Computer Vision containers. Samenvatting:

• Computer Vision biedt een Linux-container voor Docker, die Lezen inkapselen.
• Voor de leescontainer-afbeelding is een toepassing vereist om deze uit te voeren.
• Container-afbeeldingen worden uitgevoerd in Docker.
• U kunt de REST API of SDK gebruiken om bewerkingen in OCR-leescontainers aan te roepen door de host-URI van de container op te geven.
• U moet factureringsgegevens opgeven bij het instantiëren van een container.

Volgende stappen

• Controleer Containers configureren voor configuratie-instellingen
• Bekijk het OCR-overzicht voor meer informatie over het herkennen van gedrukte en handgeschreven tekst
• Raadpleeg de Read-API voor meer informatie over de methoden die door de container worden ondersteund.
• Raadpleeg Veelgestelde vragen (FAQ) voor het oplossen van problemen met betrekking tot de functionaliteit van Computer Vision.
• Gebruik meer Cognitive Services-containers