Soracom

Users

ドキュメント

アルゴリズムをインストールする

エッジコンピューターで撮影した画像や動画を処理するアプリケーションを「アルゴリズム」と呼びます。アルゴリズムは、エッジコンピューターにインストールして使用します。

  • エッジコンピューターに同時にインストールできるアルゴリズムは、1 種類のみです。
  • Mosaic コンソールに用意されているアルゴリズムは、S+ Camera シリーズ にのみインストールできます。
  • Mosaic コンソールに用意されているアルゴリズムについては、アルゴリズム一覧 を参照してください。
独自のアルゴリズムを開発するには

独自のアルゴリズムを開発する手順、および開発したアルゴリズムをインストールする手順については、独自のアルゴリズムを開発する を参照してください。

操作を始める前に準備が必要です (クリックして確認してください)

(1) エッジコンピューターを準備して SORACOM ユーザーコンソールに登録する

詳しくは、「S+ Camera シリーズユーザーガイド」の S+ Camera シリーズの初期設定を行う を参照して、このページで説明されている操作をすべて行ってください。

(2) エッジコンピューターが Mosaic コンソールに接続していることを確認する

詳しくは、SORACOM プラットフォームへの接続状況を確認する を参照してください。

準備完了

アルゴリズムをインストールする

サンプルアルゴリズムの Check Environment settings を例にして、アルゴリズムをインストールする操作を説明します。

Check Environment settings は、Mosaic コンソールで設定した環境変数を表示し、定期的に現在の時間をログに出力するアルゴリズムです。

データ通信料金が発生します

アルゴリズムのインストールでは、エッジコンピューターがアルゴリズムを SORACOM プラットフォームからダウンロードするため、データ通信料金 が発生します。

  1. Mosaic コンソール にアクセスし、アルゴリズムをインストールするエッジコンピューターのデバイス ID をクリックします。

    デバイス一覧画面 デバイス一覧画面

    デバイス詳細画面の [概要] タブが表示されます。

  2. [アルゴリズム][サンプルアルゴリズムをインストール...] の順にクリックします。

    サンプルアルゴリズムをインストール サンプルアルゴリズムをインストール

    S+ AI マーケットで購入した 3rd party アルゴリズムをインストールするには
    S+ AI マーケット で購入した 3rd party アルゴリズムをインストールする場合は、[アルゴリズム][3rd party アルゴリズムをインストール...] の順にクリックします。
  3. [Check Environment settings][インストール] の順にクリックします。

    インストール インストール

    Check Environment settings がインストールされ、パラメータ (環境変数) を指定する画面が表示されます。この画面の操作について詳しくは、エッジコンピューターごとに任意のパラメータを渡す (環境変数) を参照してください。

  4. サンプルアルゴリズム Check Environment settings が出力したログをダウンロードします。

    詳しくは、ログをダウンロードする を参照してください。

    ダウンロードしたログを解凍すると、エッジコンピューターに渡されたパラメータ (環境変数) が出力されていることが確認できます。

    PreSetup
    INFO 2022-06-10 07:18:37,440 <module> CameraApp.py 35 SORACOM_ENV_MODE = 1
    INFO 2022-06-10 07:18:37,441 <module> CameraApp.py 36 SORACOM_ENV_WAIT = 240
    INFO 2022-06-10 07:18:37,441 <module> CameraApp.py 37 SORACOM_ENV_CROP_TOP = 20
    INFO 2022-06-10 07:18:37,441 <module> CameraApp.py 38 SORACOM_ENV_CROP_BOTTOM = 30
    INFO 2022-06-10 07:18:37,441 <module> CameraApp.py 39 SORACOM_ENV_CROP_LEFT = 40
    INFO 2022-06-10 07:18:37,441 <module> CameraApp.py 40 SORACOM_ENV_CROP_RIGHT = 50
    INFO 2022-06-10 07:18:37,442 <module> CameraApp.py 41 SORACOM_ENV_UPLOAD_SIZE_W = 640
    INFO 2022-06-10 07:18:37,442 <module> CameraApp.py 42 SORACOM_ENV_UPLOAD_SIZE_H = 480
    INFO 2022-06-10 07:18:37,442 <module> CameraApp.py 43 SORACOM_ENV_URI = http://example.jp/
    INFO 2022-06-10 07:18:37,442 <module> CameraApp.py 44 SORACOM_ENV_FREE_PARAM = {"key": "value"}
    INFO 2022-06-10 07:18:37,442 <module> CameraApp.py 45 SORACOM_EXEC_PARAM = ['/opt/soracom/bin/CameraApp0/CameraApp0', '--option', '1']
    INFO 2022-06-10 07:18:37,443 Interval CameraApp.py 51 CameraApp0_Null is working.
    INFO 2022-06-10 07:18:37,443 Interval CameraApp.py 52 Current Time: 2022-06-10 07:18:37.443386
    

ログをダウンロードする

エッジコンピューターから Harvest Files にログをアップロードし、Harvest Files から PC にログをダウンロードします。

ログをダウンロードすると Harvest Files への書き込み料金と読み出し料金が発生します

ログのダウンロードでは、エッジコンピューターから Harvest Files にログをアップロードし、続けて Harvest Files からダウンロードするため、データ通信料金Harvest Files への書き込み料金および Harvest Files からの読み出し料金 が発生します。

  1. Mosaic コンソール にアクセスし、ログをダウンロードするエッジコンピューターのデバイス ID をクリックします。

    デバイス一覧画面 デバイス一覧画面

    デバイス詳細画面の [概要] タブが表示されます。

  2. [アルゴリズム][ログをダウンロード] の順にクリックします。

    ログをダウンロード ログをダウンロード

    アルゴリズムが出力したログがダウンロードされます。ログは gzip 形式で圧縮されています。gunzip コマンドなどで解凍してください。

一度ダウンロードしたログはエッジコンピューターから削除されます

再度ログをダウンロードすると、前回のログの続きがダウンロードされます。

アルゴリズムをアンインストールする

アルゴリズムは、S+ Camera シリーズ の電源が入っている間は動作し続けます。アルゴリズムをアンインストールすと、アルゴリズムが動作を終了します。

アルゴリズムのアンインストールは、Inventory を経由して行います。デバイスの [ステータス]ONLINE が表示されていることを確認してください。

  1. デバイスの概要画面で [アルゴリズム][現在のアルゴリズムをアンインストール] の順にクリックします。

    現在のアルゴリズムをアンインストール 現在のアルゴリズムをアンインストール

  2. [OK] をクリックします。

    OK OK

    アンインストールが完了すると、アルゴリズムが動作を終了します。また、[現在のアルゴリズム] に「アルゴリズムがインストールされていない」と表示されます。

    現在のアルゴリズム 現在のアルゴリズム