2026-02-10

Quuppa Simulator と QuickIPS による出力データ分析

Quuppaとは?

 Quuppaを IPS/RTLS と呼ばれる屋内位置測位システムであり、本システムにより屋内の多数の人・モノの位置をPC等の端末上で視認あるは追跡することが可能です。

 Quuppa の導入検討時、導入担当者は管理対象となる人・モノの最大数及び位置情報の更新頻度を想定し、Quuppa及びアプリケーションが自社の要求仕様を満たすかどうかをチェックしたいと思うかもしれません。その際に有用なのが Quuppa Positioning Engine (QPE)のSimulator 機能と、当社の QuickIPS for Quuppa QuickIPS)です。この2つのツールにより導入担当者は送信データ件数の確認、負荷テスト等を行う事ができます。

QPE Simulator ができること
 QPE の Simulatiorはタグやロケータ(タグが発する信号を受信するセンサー)が無くても、多数のタグの位置情報データを発生させてアプリケーションに送信します。

QuickIPS Log stream analyzer ができること
  1. UDP Push により送信されるタグの位置情報をlocLogテーブルに自動取込/照会
  2. File Logging により作成される位置情報ファイル(テキスト)をPELogテーブルに手動取込/照会
  3. Estimate、UDP Push と File Logging のデータを比較・分析
  4. Estimate、UDP Push と File Logging のデータのグラフ化
注:
Estimateとは、後述する Simulator で設定に基づく予測される位置情報件数。

本稿 では、QPEの Simulator の設定方法の一部と、Log stream analyzer (Analyzer)の特徴を説明します。。

QPE Simulatiorの設定

Simulator設定時に注意すべき項目は以下の通りです。

注:
  • Simulation 全般の設定方法については、Quuppa付属のマニュアルを参照してください。
  • 今回当方が使用したQPE用マシンは Intel NUC(Deb-Kit付属機)です。

タグの個数

QSP(Quuppa Site Planner) で使用するタグの個数を指定します。


送信間隔とログ出力

QSP の左ペインで"Output targets"をクリックして「Output Targets」タグをクリック。さらに"Add output targets"をクリックして、図の「Target」ウインドウを開きます。

送信間隔(Interval)

送信間隔を0.1秒~600秒の範囲で指定します。例えば、高速移動するアイスホッケー選手の位置をリアルタイムで計測するようなアプリケーションなら0.1秒のような短い間隔を、老人ホームで入居者の居場所を表示する場合は数秒~のように設定します。

出力方法(Target)

出力方法をテキストログ(File)、UDP、MQTTから選択します。ここでは位置情報のテキストログとして保存するので「File」を選択し、[Folder]にはファイルパスを入力します。
尚、UDP/MQTTを同時に登録し、同時実行することも可能です。

Simulator を開始する

この後、Simulator の起動方法は少し解り難いです。
  1. QPE機のデスクトップ上にある"Start QPE Simulator"アイコンをダブルクリックして実行。さらにQSP(Quuppa Site Planner)の右ペイン「Project」の「Simulator」タグをクリックして"Start Simulator..."をクリックして Simulatorを起動します。
  2. デスクトップ上の"QPE Web Console"をダブルクリックしてコンソールを起動します。
  3. 「File Logging」の"Start"をクリックするSimulatorが出力する位置情報のログが上記で指定したファイルパスに保存されます。また、「UDP Push」または「MQTT Publisher」の "Start"をクリックすれば、それぞれの出力が開始されます。
 注:QuickIPS は現時点では UDP Pushに対応しており、MQTT には対応していません。

QPE用のPC/Serverについて

Simulatorを Start させた後、 Quuppa System Simulator Status ウインドウに「Bad, packets lost...」と出る場合は、QPE 搭載機の仕様が不足している可能性があります。


locLog/PELogテーブル

 上述の UDP Push を実行すると、QuickIPS は 出力された位置情報を内部の locLog テーブルに自動的に書き込むことができます。
 また  QuickIPS はFile Logging により作成された位置情報テキストファイルを "Import"ボタンにより PELog テーブルに取り込むことができます。
 これらのデータを照会するには、Menu画面の"Log"ボタンにより Location Log(logLog)または Positioning Engine Log(PE Log)を開いてください。
 これらの2つのテーブルは UDP Push または File Logging によって出力された生データを1行ずる照会するときに使用しますが、それらのデータの集計分析する場合は後述の 「QuickIPS Log stream analyzer」を使用してください。

注:
locLogまたはPELogへのデータ取込の方法は、QuickIPS付属のドキュメントを参照して下さい。

QuickIPS Log stream analyzer 

 QPEはタグの位置情報を大量に出力しますが、その出力の量的チェックを行うのが本機能です。
注:
QPE は Simulator 出力の他に、Tracking出力(実際のタグの位置データ出力)ができます。

 

Analyzerの使用方法

Log stream analyzer 画面の使用方法を説明します。
  1. まず、調査対象とするログの開始時間を[Log time start]に入力。ここに入力した時刻部分(例:10:57:16)が画面左の最上部に表示され、これがタイムテーブルの始点となります。

  2. [Log interval(sec.)]にはTime range ログの時間間隔を指定します。この値が開始時刻に加算されて終了時刻になります。開始時刻から終了時刻の間隔を[Time range]と言います。

主要項目の説明

Log stream analyzer の主要な機能は以下の通りです。

区分 項目 説明
Estimate Count Time range 間に出力される見込み*2のデータ件数
例:
10:57:16~10:57:20の4秒の間に、200件のデータが出力される見込み
Cum. Time range の最初から終了迄に出力される 見込み*2の累積データ件数
例:
10:57:16~10:57:32の16秒の間に、累積で800件のデータが出力される見込み
Location Log
(locLog)
Count UDP Push により、各Time range 間に Location Log (locLogテーブル)に登録されたデータ件数
例:
10:57:16~10:57:20の4秒の間に、195件のデータが作成された(EstimateのCountと不一致)
Cum. UDP Push により、Times range の最初から終了迄に Location log (locLogテーブル)に 登録された累積データ件数
例:
10:57:16~10:57:32の16秒の間に、800件のデータが登録された(EstimateのCumと一致)
Unique UDP Push により、各Timestamp range 間に Location Log (locLogテーブル)に登録されたユニーク*3データ件数
例:
10:57:16~10:57:20の4秒の間に、160件のユニークデータが作成された(これは4秒間に作成されると見込まれた200件のユニークデータ件数よりも40件少ない)
Unique cum. UDP Push により、Time rangeの 最初から終了迄に Location Log (locLogテーブル)に 登録されたユニーク累積データ件数
例:
10:57:16~10:57:28の12秒の間に、200件のユニークデータが登録された(管理対象となる200件のタグを全て検知するのに、12秒を要した)
Positioning Engine log
(PE Log)*1
Count File Logging により、各Time range間に Positioning Engine Log(Simulator_user-prefix_yyyymmdd_hhmmss.log)に記録されたデータ件数。
例:
10:57:16~10:57:20の4秒の間に、195件のデータが登録された(EstimateのCountと不一致)
Cum. File Logging により、Time range の最初から終了迄に Positioning Engine Log(Simulator_user-prefix_yyyymmdd_hhmmss.log)に記録された累積データ件数
例:
10:57:16~10:57:32の16秒の間に、801件のデータが作成された
(EstimateのCumと不一致)
Unique File Logging により、各Time range 間に Positioning Engine Log(Simulator_user-prefix_yyyymmdd_hhmmss.log)に記録されたデータ件数。
例:
10:57:16~10:57:20の4秒の間に、161件のユニークデータが作成された(これは4秒間に作成されると予測された200件のユニークデータ件数よりも39件少ない)
Unique cum. UDP Push により、Time rangeの 最初から終了迄に Positioning Engine Log(Simulator_user-prefix_yyyymmdd_hhmmss.log)に記録されたユニーク累積データ件数
例:
10:57:16~10:57:28の12秒の間に、200件のユニークデータが登録された(管理対象となる200件のタグを全て検知するのに、12秒を要した)

注:
*1. QuickIPSで本ログを照会するには、"Import"を実行する必要有。
*2.「見込み」は Log annotation に入力された Num. of tags、Interval(sec.) 及び Time range により算出される。
*3. ユニークとは重複がないこと。 例えば、「A,B,C,A,D,B」の元データがある時、ユニークデータは「A,B,C,D」となり、ユニークデータ件数は4件となる。

Log Annotation について

Log Annotation は ユーザが Simulator または QPE のログ作成時の条件を手入力により記録する機能です。 これにより、Log stream analyzer の Estimate の Count と Cum. を算出します。 尚、 Log stream analyzer の記録は、Menu 画面の "Analysis"→"Log Annotations" で照会できます。

Nucky T