Uzamsal analiz kapsayıcısını (Önizleme) yükleyip çalıştırın

Uzamsal analiz kapsayıcısı, kişiler, taşınanlar ve fiziksel ortamlardaki nesnelerle etkileşimler arasındaki uzamsal ilişkileri anlamak için gerçek zamanlı akış videosunu analiz etmenizi sağlar. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır.

Önkoşullar

  • Azure aboneliği- ücretsiz olarak bir tane oluşturun
  • Sorumlu AI koşullarını kabul etmek ve kaynak oluşturmak için Azure hesabınıza bir Bilişsel Hizmetler Katkıda Bulunanı rolü atanmış olması gerekir. Bu rolü hesabınıza ataması için yöneticinize başvurun.
  • Azure aboneliğiniz olduktan sonra, anahtarınızı ve uç noktanızı almak Için Azure Portal Standart S1 katmanı için bir Görüntü İşleme kaynağı oluşturun görüntü işleme bir kaynak oluşturun. Dağıtıldıktan sonra Kaynağa Git ' e tıklayın.
    • Uzamsal analiz kapsayıcısını çalıştırmak için oluşturduğunuz kaynaktaki anahtar ve uç nokta gerekir. Anahtarınızı ve uç noktanızı daha sonra kullanacaksınız.

Uzamsal analiz kapsayıcısı gereksinimleri

Uzamsal analiz kapsayıcısını çalıştırmak için, NVIDIA Tesla T4 GPU 'suolan bir işlem cihazına ihtiyacınız vardır. GPU hızlandırmalı Azure Stack Edge kullanmanızı öneririz, ancak kapsayıcı, en düşük gereksinimleri karşılayan diğer masaüstü makineler üzerinde çalışır. Bu cihaza ana bilgisayar olarak başvuracağız.

Azure Stack Edge, ağ veri aktarımı özelliklerine sahip bir hizmet olarak donanım ve bir AI özellikli sınır bilgi işlem aygıtıdır. Ayrıntılı hazırlık ve kurulum yönergeleri için Azure Stack Edge belgelerinebakın.

Gereksinim Açıklama
Kamera Uzamsal analiz kapsayıcısı belirli bir kamera markasına bağlı değil. Kamera cihazının şunları yapması gerekir: Real-Time Akış Protokolü (RTSP) ve H. IBU kodlamayı destekler, ana bilgisayar için erişilebilir olur ve 15 fps ve 1080p çözünürlükte akış yapabilir.
Linux işletim sistemi Ubuntu Desktop 18,04 LTS , ana bilgisayarda yüklü olmalıdır.

Ana bilgisayarı ayarlama

Ana bilgisayarınız için bir Azure Stack Edge cihazı kullanmanız önerilir. Farklı bir cihaz yapılandırıyorsanız Masaüstü makinesi ' ne veya bir VM kullanıyorsanız sanal makine ' ye tıklayın.

Azure Stack Edge portalında işlem yapılandırma

Uzamsal analiz, bir AI çözümünü çalıştırmak için Azure Stack ucunun işlem özelliklerini kullanır. İşlem özelliklerini etkinleştirmek için aşağıdakileri yaptığınızdan emin olun:

  • Azure Stack Edge cihazınızı bağladınız ve etkinleştirdiniz .
  • cihaza erişmek için PowerShell 5,0 veya üzeri bir sürümü çalıştıran bir Windows istemci sisteminiz vardır.
  • Bir Kubernetes kümesi dağıtmak için, Azure Stack Edge cihazınızı Azure Portal Yerel Kullanıcı arabirimi aracılığıyla yapılandırmanız gerekir:
    1. Azure Stack Edge cihazınızda işlem özelliğini etkinleştirin. İşlem özelliğini etkinleştirmek için, cihazınızın web arabirimindeki işlem sayfasına gidin.
    2. İşlem için etkinleştirmek istediğiniz bir ağ arabirimi seçin ve ardından Etkinleştir' e tıklayın. Bu, cihazınızda bu ağ arabiriminde bir sanal anahtar oluşturur.
    3. Kubernetes sınama düğümü IP adreslerini ve Kubernetes dış hizmetler IP adreslerini boş bırakın.
    4. Uygula’ya tıklayın. Bu işlem, iki dakika sürebilir.

İşlem yapılandırma

Bir uç işlem rolü ayarlama ve bir IoT Hub kaynağı oluşturma

Azure Portal, Azure Stack Edge kaynağına gidin. Genel bakış sayfasında veya gezinti listesinde Edge COMPUTE Başlarken düğmesine tıklayın.  Uç Işlem yapılandırma   kutucuğunda Yapılandır' ı tıklatın.

Bağlantı

Edge Işlem yapılandırma   sayfasında, mevcut bir IoT Hub seçin veya yenisini oluşturmayı seçin. Varsayılan olarak, bir IoT Hub kaynağı oluşturmak için standart (S1) Fiyatlandırma Katmanı kullanılır. Boş bir katman IoT Hub kullanmak için, bir tane oluşturun ve ardından seçin. IoT Hub kaynak, Azure Stack Edge kaynağı tarafından kullanılan aynı abonelik ve kaynak grubunu kullanır

Oluştur’a tıklayın. IoT Hub kaynak oluşturma birkaç dakika sürebilir. IoT Hub kaynağı oluşturulduktan sonra, yeni yapılandırmayı göstermek için Edge işlem bölmesini Yapılandır ' ı güncellecektir. Edge işlem rolünün yapılandırıldığını doğrulamak için, Işlem yapılandırma kutucuğunda yapılandırmayı görüntüle ' yi seçin   .

Edge cihazında Edge hesaplama rolü ayarlandığında, iki cihaz oluşturur: bir IoT cihazı ve bir IoT Edge cihaz. Her iki cihaz de IoT Hub kaynağında görüntülenebilir. Azure IoT Edge çalışma zamanı IoT Edge cihazda zaten çalışıyor.

Not

Azure Stack Edge üzerinde MPS 'yi etkinleştirme

bir Windows istemcisinden uzaktan bağlanmak için aşağıdaki adımları izleyin.

  1. yönetici olarak bir Windows PowerShell oturumu çalıştırın.

  2. Windows Uzaktan Yönetimi hizmetinin istemciniz üzerinde çalıştığından emin olun. Komut istemine şunları yazın:

    winrm quickconfig
    

    daha fazla bilgi için bkz. Windows Uzaktan Yönetimi için yükleme ve yapılandırma.

  3. Dosyada kullanılan bağlantı dizesine bir değişken atayın hosts .

    $Name = "<Node serial number>.<DNS domain of the device>"
    

    <Node serial number>Ve <DNS domain of the device> , cihazınızın seri numarasını ve DNS etki alanını değiştirin. Cihazların yerel Web Kullanıcı arabirimindeki cihaz sayfasından SERTIFIKALAR sayfasından ve DNS etki alanından düğüm seri numarası değerlerini alabilirsiniz.

  4. Cihazınızın bu bağlantı dizesini istemcinin güvenilen konaklar listesine eklemek için aşağıdaki komutu yazın:

    Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force
    
  5. cihazda bir Windows PowerShell oturumu başlatın:

    Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL
    

    Güven ilişkisiyle ilgili bir hata görürseniz, cihazınıza yüklenen düğüm sertifikasının imzalama zincirinin cihazınıza erişen istemciye de yüklenip yüklenmediğini kontrol edin.

  6. İstendiğinde parolayı girin. Yerel Web Kullanıcı arabiriminde oturum açmak için kullanılan parolayı kullanın. Varsayılan yerel Web UI parolası Parola1'dır. Uzak PowerShell kullanarak cihaza başarıyla bağlandığınızda aşağıdaki örnek çıktıyı görürsünüz:

    Windows PowerShell
    Copyright (C) Microsoft Corporation. All rights reserved.
    
    PS C:\WINDOWS\system32> winrm quickconfig
    WinRM service is already running on this machine.
    PS C:\WINDOWS\system32> $Name = "1HXQG13.wdshcsso.com"
    PS C:\WINDOWS\system32> Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force
    PS C:\WINDOWS\system32> Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL
    
    WARNING: The Windows PowerShell interface of your device is intended to be used only for the initial network configuration. Please engage Microsoft Support if you need to access this interface to troubleshoot any potential issues you may be experiencing. Changes made through this interface without involving Microsoft Support could result in an unsupported configuration.
    [1HXQG13.wdshcsso.com]: PS>
    

IoT Dağıtım bildirimi

Birden çok konak bilgisayarda kapsayıcı dağıtımını basit hale getirmek için, kapsayıcı oluşturma seçeneklerini ve ortam değişkenlerini belirtmek için bir dağıtım bildirim dosyası oluşturabilirsiniz. Azure Stack Edge, diğer masaüstü makineleri ve sanal makinelerde GPU ileAzure VM için bir dağıtım bildirimi GitHub.

Aşağıdaki tabloda, IoT Edge Modülü tarafından kullanılan çeşitli Ortam Değişkenleri yer alır. Ayrıca, içinde özniteliğini kullanarak bunları yukarıda bağlantılı dağıtım bildiriminde env de spatialanalysis ayarlayın:

Ayar Adı Değer Açıklama
ARCHON_LOG_LEVEL Bilgi; Ayrıntılı Günlük düzeyi, iki değerden birini seçin
ARCHON_SHARED_BUFFER_LIMIT 377487360 Değiştirmeyin
ARCHON_PERF_MARKER yanlış Performans günlüğü için bunu true olarak ayarlayın, aksi takdirde false olması gerekir
ARCHON_NODES_LOG_LEVEL Bilgi; Ayrıntılı Günlük düzeyi, iki değerden birini seçin
OMP_WAIT_POLICY PASİF Değiştirmeyin
QT_X11_NO_MITSHM 1 Değiştirmeyin
APIKEY API Anahtarınız Bu değeri Azure portal kaynağından Görüntü İşleme toplayın. Kaynağınız için Anahtar ve uç nokta bölümünde bulabilirsiniz.
FATURALAMA Uç Nokta URI'niz Bu değeri Azure portal kaynağından Görüntü İşleme toplayın. Kaynağınız için Anahtar ve uç nokta bölümünde bulabilirsiniz.
EULA Kabul Kapsayıcının çalışması için bu değerin kabul edilecek şekilde ayarlanmış olması gerekir
GÖRÜNTÜ :1 Bu değerin, konak bilgisayarın echo $DISPLAY çıktısı ile aynı olması gerekir. Azure Stack Edge cihazların ekranı yok. Bu ayar geçerli değildir
ARCHON_GRAPH_READY_TIMEOUT 600 GPU'nız T4 veya NVIDIA 2080 Ti değilse bu ortam değişkenini ekleyin
ORT_TENSORRT_ENGINE_CACHE_ENABLE 0 GPU'nız T4 veya NVIDIA 2080 Ti değilse bu ortam değişkenini ekleyin
KEY_ENV ASE Şifreleme anahtarı Bu ortam değişkeni, Video_URL bir dize ise ekleyin
IV_ENV Başlatma vektörü Bu ortam değişkeni, Video_URL bir dize ise ekleyin

Önemli

Kapsayıcıyı çalıştırmak için , Eula Billing ve seçenekleri ApiKey belirtilmelidir; aksi takdirde kapsayıcı başlamaz. Daha fazla bilgi için bkz. Faturalama.

Azure Stack Edge cihazları, masaüstü makinesi veya Gpu ile Azure VM için dağıtım bildirimini kendi ayarlarınıza ve işlemlerinize göre güncelleştirin ve aşağıdaki Azure CLI komutunu kullanarak kapsayıcıyı konak bilgisayara bir IoT Edge Modülü olarak dağıtabilirsiniz.

sudo az login
sudo az extension add --name azure-iot
sudo az iot edge set-modules --hub-name "<iothub-name>" --device-id "<device-name>" --content DeploymentManifest.json --subscription "<name or ID of Azure Subscription>"
Parametre Açıklama
--hub-name Azure IoT Hub adı.
--content Dağıtım dosyasının adı.
--target-condition Konak IoT Edge için cihaz adınız.
-–subscription Abonelik kimliği veya adı.

Bu komut dağıtımı başlatacak. Dağıtım durumunu görmek için Azure IoT Hub örneğinin Azure portal sayfasına gidin. Durum 417 olarak gösterebilir – Cihaz kapsayıcı görüntülerini indirmeyi bitirip çalışmaya başlayana kadar cihazın dağıtım yapılandırması ayarlanmaz.

Dağıtımın başarılı olduğunu doğrulama

Kapsayıcının çalıştırlı olduğunu doğrulamanın birkaç yolu vardır. Çalışma Zamanı Durumu'IoT Edge modülünün Ayarlar modülünün Çalışma Zamanı Azure IoT Hub modülünün çalışma zamanı Azure portal. Çalışma Zamanı Durumu için İstenen Değer ve Bildirilen Değer'in Çalışıyor olduğunu onaylar.

Örnek dağıtım doğrulaması

Dağıtım tamamlandıktan ve kapsayıcı çalışmaya başladıktan sonra, konak bilgisayar olayları sunucuya Azure IoT Hub. İşlemlerin sürümünü kullandıysanız, dağıtım bildiriminde yapılandırılan her kamera .debug için bir görselleştirici penceresi görüntülenir. Artık dağıtım bildiriminde izlemek istediğiniz satırları ve bölgeleri tanımlayabilir ve yeniden dağıtmak için yönergeleri izleyebilirsiniz.

Uzamsal Analiz tarafından gerçekleştirilen işlemleri yapılandırma

Kapsayıcıyı bağlı kameraları kullanmak, işlemleri yapılandırmak ve daha fazlasını yapmak üzere yapılandırmak için Uzamsal Analiz işlemlerini kullanabilirsiniz. Yapılandırılan her kamera cihazı için Uzamsal Analiz işlemleri, JSON iletilerinin çıkış akışını oluşturur ve bu akışlar Azure IoT Hub.

Kapsayıcı tarafından oluşturulan çıkışı kullanma

Kapsayıcı tarafından oluşturulan çıkışı tüketmek için aşağıdaki makalelere bakın:

Uzamsal Analizi kayıtlı bir video dosyasıyla çalıştırma

Uzamsal Analizi hem kayıtlı hem de canlı video ile kullanabilirsiniz. Uzamsal Analizi kayıtlı video için kullanmak üzere bir video dosyasını kaydetmeyi ve mp4 dosyası olarak kaydetmeyi deneyin. Azure'da bir blob depolama hesabı oluşturun veya var olan bir hesabı kullanın. Ardından aşağıdaki blob depolama ayarlarını Azure portal: 1. Güvenli aktarım gerekli'i Devre Dışı olarak değiştirme 2. Blob genel erişimine izin ver'i Etkin olarak değiştirme

Kapsayıcı bölümüne gidin ve yeni bir kapsayıcı oluşturun veya var olan bir kapsayıcıyı kullanın. Ardından video dosyasını kapsayıcıya yükleyin. Karşıya yüklenen dosyanın dosya ayarlarını genişletin ve SAS Oluştur'a tıklayın. Sona Erme Tarihi'nin test süresini kapsayacak kadar uzun olduğundan emin olun. İzin Verilen Protokoller'i HTTP olarak ayarlayın (HTTPS desteklenmiyor).

SAS Belirteci ve URL'si Oluştur'a tıklayın ve Blob SAS URL'sini kopyalayın. ile başlayanı https değiştirin http ve URL'yi video kayıttan yürütmeyi destekleyen bir tarayıcıda test edin.

Azure Stack Edge cihazınızın, masaüstü makinenizin veya Azure VM'nizin dağıtım bildiriminde ifadesini tüm grafikler için oluşturduğunuz URL ile VIDEO_URL GPU ile değiştirin. olarak VIDEO_IS_LIVE ayarlayın false ve Güncelleştirilmiş bildirimle Uzamsal Analiz kapsayıcısı yenidenploy. Aşağıdaki örneğe bakın.

Uzamsal Analiz modülü video dosyasını tüketerek başlayacak ve sürekli olarak otomatik olarak yeniden oynatacak.

"zonecrossing": {
    "operationId" : "cognitiveservices.vision.spatialanalysis-personcrossingpolygon",
    "version": 1,
    "enabled": true,
    "parameters": {
        "VIDEO_URL": "Replace http url here",
        "VIDEO_SOURCE_ID": "personcountgraph",
        "VIDEO_IS_LIVE": false,
      "VIDEO_DECODE_GPU_INDEX": 0,
        "DETECTOR_NODE_CONFIG": "{ \"gpu_index\": 0, \"do_calibration\": true }",
        "SPACEANALYTICS_CONFIG": "{\"zones\":[{\"name\":\"queue\",\"polygon\":[[0.3,0.3],[0.3,0.9],[0.6,0.9],[0.6,0.3],[0.3,0.3]], \"events\": [{\"type\": \"zonecrossing\", \"config\": {\"threshold\": 16.0, \"focus\": \"footprint\"}}]}]}"
    }
   },

Sorun giderme

Kapsayıcıyı başlatma veya çalıştırma sırasında sorunlarla karşılaşırsanız yaygın sorunlar için telemetri verilerine ve sorun gidermeye bakın. Bu makale ayrıca günlük oluşturma, toplama ve sistem durumunu toplama hakkında bilgi içerir.

Bilişsel Hizmetler kapsayıcısını çalıştırırken sorun yaşıyorsanız Microsoft tanılama kapsayıcısını kullanmayı deneyebilirsiniz. Dağıtım ortamınızda Bilişsel Hizmetler kapsayıcılarının beklendiği gibi çalışmasını engelleyebilecek yaygın hataları tanılamak için bu kapsayıcıyı kullanın.

Kapsayıcıyı almak için aşağıdaki Docker pull komutunu kullanın:

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

Ardından kapsayıcıyı çalıştırın, uç noktanızla değiştirin {ENDPOINT_URI} ve kendi {API_KEY} anahtarınızla değiştirin:

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

Kapsayıcı, faturalama uç noktasına ağ bağlantısını test eder.

Faturalama

Uzamsal Analiz kapsayıcısı, Azure hesabınıza Görüntü İşleme bir kaynak kullanarak faturalama bilgilerini Azure'a gönderir. Genel önizlemede Uzamsal Analiz kullanımı şu anda ücretsizdir.

Azure bilişsel hizmetler kapsayıcıları, ölçüm/faturalandırma uç noktasına bağlı kalmadan çalıştırılmak üzere lisanslanmaz. Her zaman Faturalandırma bitiş noktasıyla faturalandırma bilgilerini iletmek için kapsayıcıları etkinleştirmeniz gerekir. Bilişsel hizmetler kapsayıcıları, Microsoft 'a, analiz edilen video veya resim gibi müşteri verileri göndermez.

Özet

Bu makalede, uzamsal analiz kapsayıcısını indirmek, yüklemek ve çalıştırmak için kavramların ve iş akışının öğrenmiş olursunuz. Özet:

  • Uzamsal analiz, Docker için bir Linux kapsayıcısıdır.
  • Kapsayıcı görüntüleri Microsoft Container Registry indirilir.
  • Kapsayıcı görüntüleri Azure IoT Edge ' de IoT modülleri olarak çalışır.
  • Kapsayıcıyı yapılandırma ve bir konak makinesine dağıtma.

Sonraki adımlar