Phew Mantis Integration Workshop

Meeting Date	@October 9, 2020
Project	PHEW
Project Type	Avrupa Birliği
Participants	Behzad NaderalvojoudEsra OKUYANLatif Bahadır ALTUNMustafa Uygar BİLGE
Editor of The Page	Latif Bahadır ALTUN

Data Monitoring

Put Event

Service Description
Put Event servisiyle hastanın girmiş olduğu datalar üzerinden doktorun öneride bulunmuş olduğu aktiviteler Mantis'in aşağıdaki servisine gönderilir. Event'ler burada depolanır. Mantis bu servis sayesinde gönderilen aktivitelerin depolamasını yapıyor. Henüz çalışmalarını tamamlamamış oldukları "hastadan gelen verilere göre otomatik event tanımlama" algoritmaları bu verilerle bizlere dönüş sağlayacak.

Url
http://put-event.phe.mantam.com.tr

Data

[
    {
        "dataTimestamp": 1593798708912,
        "eventCode": "physical-activity",
        "eventValue": "running",
        "evaluationStartTime": 1593768588912,
        "evaluationEndTime": 1593798708912,
        "userCode": "101",
        "createdBy": "pilot"
    }
]

Response
```
Process is done for 1 event data
```

Comments
İlgili servis çalışmalarında herhangi bir hata veya sorun olmadığı gibi soru işaretleri de yok. Entegrasyon doğru şekilde çalışıyor.

Put Sensor

Service Description
Put Sensor servisiyle hastanın girmiş olduğu datalar Mantis'in aşağıdaki servisine gönderilir. Sensor datalar burada depolanır. Mantis bu servis sayesinde ARD tarafından hastadan alınıp gönderilen plan parametre değerlerinin depolamasını yapıyor. Henüz çalışmalarını tamamlamamış oldukları "hastadan gelen verilere göre otomatik event tanımlama" algoritmalarında kullanılmak üzere data analizini yaptıkları verilerin otomatik event gönderme işlemlerini bu datalarla yapacaklar.

Url
http://put-sensor.phe.mantam.com.tr

Data

[
    {
        "dataTimestamp": 1593776064565,
        "userCode": "101",
        "sensorCode": "heart-beat",
        "sensorValue": 104.0
    },
    {
        "dataTimestamp": 1593776064565,
        "userCode": "101",
        "sensorCode": "motion-hand-accelerometer-z",
        "sensorValue": 3.51048
    }
]

Response
```
Process is done for 2 sensor data
```

Comments
İlgili servis çalışmalarında herhangi bir hata veya sorun olmadığı gibi soru işaretleri de yok. Entegrasyon doğru şekilde çalışıyor.

Data Analytics

Get Event

Service Description
Get Event servisiyle Mantis, kendisine entegre servislere Put Event servisiyle gönderilmiş olan dataların zamana bağlı olan veya zaman bağımsız değer dönüşlerini yapacaklar. Belirtilen başlangıç ve bitiş zamanı içerisinde belirtilen eventların belirtilen user için listesinin dönüşünü yapıyorlar.

Url
get-event.phe.mantam.com.tr

Data

Data-1 (timeBased)

{
    "eventCode": "physical-activity",
    "userCode": "101",
    "queryStartTime": 1607202000000,
    "queryEndTime": 1609275600000,
    "queryType": "timeBased",
    "eventValues": ["lying", "other"]
}

Data-2 (aggregateBased)

{
    "eventCode": "physical-activity",
    "userCode": "101",
    "queryStartTime": 1607202000000,
    "queryEndTime": 1609275600000,
    "group": "day",
    "queryType": "aggregateBased",
    "eventValues": ["lying", "other"]
}

Response

Response - 1 (timeBased)

{
    "data": [
        [
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ],
						...
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ],
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ]
        ],
        [
            [
                "{\"data_timestamp\": \"2020-12-19 23:29:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ],
            [
                "{\"data_timestamp\": \"2020-12-20 01:11:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
            [
                "{\"data_timestamp\": \"2020-12-20 02:53:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ],
            [
                "{\"data_timestamp\": \"2020-12-20 04:35:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ],
            [
                "{\"data_timestamp\": \"2020-12-20 06:17:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
            [
                "{\"data_timestamp\": \"2020-12-20 07:59:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ],
            [
                "{\"data_timestamp\": \"2020-12-20 09:41:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
							...
            [
                "{\"data_timestamp\": \"2020-12-20 11:23:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ],
            [
                "{\"data_timestamp\": null, \"event_value\": null, \"value\": 0}"
            ],
            [
                "{\"data_timestamp\": \"2020-12-20 13:05:31.608Z\", \"event_value\": \"other\", \"value\": 1}"
            ]
        ]
    ]
}

Response - 2 (aggregateBased)

{
    "data": [
        [
            "{\"event_value\": \"Nordic-walking\", \"value\": 199}"
        ],
        [
            "{\"event_value\": \"ascending-stairs\", \"value\": 157}"
        ],
        [
            "{\"event_value\": \"cycling\", \"value\": 232}"
        ],
        [
            "{\"event_value\": \"descending-stairs\", \"value\": 147}"
        ],
        [
            "{\"event_value\": \"ironing\", \"value\": 232}"
        ],
        [
            "{\"event_value\": \"lying\", \"value\": 267}"
        ],
        [
            "{\"event_value\": \"other\", \"value\": 1245}"
        ],
        [
            "{\"event_value\": \"rope-jumping\", \"value\": 127}"
        ],
        [
            "{\"event_value\": \"running\", \"value\": 210}"
        ],
        [
            "{\"event_value\": \"sitting\", \"value\": 231}"
        ],
        [
            "{\"event_value\": \"standing\", \"value\": 213}"
        ],
        [
            "{\"event_value\": \"vacuum-cleaning\", \"value\": 225}"
        ],
        [
            "{\"event_value\": \"walking\", \"value\": 219}"
        ]
    ]
}

Comments
1. Event-code'lar belli bir kodlama sistemi üzerine kurulu olsun ki veri dönüşünde anlamlandırma kolay olsun.
1. Bu iki tarih aralığında her gün için dönüş sağlanır. Günlük ne geldiyse onu gösterir.
1. EventValue'lar hangi sırayla giderse o sırayla dönüş sağlanır.
1. AggregateBased herhangi bir zamana bağlı olmayan.

Get Sensor

Service Description
Get Sensor servisiyle Mantis, kendisine entegre servislere Put Sensor servisiyle gönderilmiş olan dataların dönüşlerini yapacaklar. Belirtilen başlangıç ve bitiş zamanı içerisinde belirtilen sensörlerin belirtilen user için listesinin dönüşünü yapıyorlar.

Url
get-sensor.phe.mantam.com.tr

Data

{
"sensorCode": "motion-hand-accelerometer-x", 
"userCode": "101", 
"queryStartTime": 1607202000000, 
"queryEndTime": 1609275600000, 
"aggregate": "yes"
}

Response

{
    "data": [
        "{\"sensor_code\": \"motion-hand-accelerometer-x\", \"min\": -41.2779, \"max\": 9.83412, \"avg\": -3.183686812260073, \"sum\": -109958.1751218384}"
    ]
}

Comments
1. En son kayda göre veri dönüşü yapılır her şey sensöre dönüştürülerek gönderilir. İki tarih aralığında.
1. Dönen responselardan girilen değere ilişkin bir hastalık kritik-normal seviyesi gibi değerler okunamayacak.
1. Entegrasyonda doktora ihtiyaç olmadan öğrenme algoritması henüz çalışmıyor. Yani herhangi bir learning algoritmasının çalıştığı servis henüz aktif değil.
1. Analiz sistemini ister kendiniz yapın, ister bizim sistemimize yönlendirme yapın.
1. Sizin yapacağınız bir işlemi biz yaptık ifadesini ekledi. Analiz sayfasının front-end kısmını aslında bizim yapmamız gerektiğini ifade etti.
1. Veri yüklemesi yaparken yüke dikkat edelim. Sunucu yük anlamında test edilmiş ve kaynak verilmiş durumda değil. Development için ayrılmış sadece.
Özetle
Mantis Entegrasyonu'nda sistemimizde entegrasyona ilişkin servislerden Put-Event ve Put-Sensor servislerini olması gerektiği şekilde kullanabiliyoruz. Bu servislere hakem sunumuna kadar veri beslemesi yapılacak. Mantis'in analiz sayfasında ARD'nin göndermiş olduğu veriler görüntülenebilecek ve gösterilebilecek. Bu çalışmanın tamamlanması da Get-Event ve Get-Sensor servislerini doğrudan etkiler bir sonuca varacak. ARD servislerinden Get-Event ve Get-Sensor servislerinin response'u kullanılabilecek. Fakat hayal ettiğimiz gibi hastaya yada doktora hastalığın durumu ile ilgili bilgi vermekten ziyade bizim veritabanımızda da mevcut bulunan dataları kullanarak alabileceğimiz min, max, sum, average gibi dönüşler olacak. Event'ın doktora ihtiyaç olmadan otomatikleştirilmesi ve Sensor Data'larla doktora ihtiyaç duymadan hastalık durumuyla ilgili bilgi verilmesi çalışmalarını Mantis henüz tamamlamamış ve çalışmalarına devam ediyorlar.
ARD'nin yapmış olduğu Internal Learning Engine sayesinde hayal ettiğimiz hastalık durumu ile ilgili tahmini kullanıcıya döndürebilir durumdayız. Mantis'ten bu yönde veri alamasak bile Rule-Based ve RandomForest çalışmalarımızla ilgili durum tespiti kendi içimizde yapılabiliyor. External Learning Engine çalışması Mantis tarafından tamamlandığında yeni bir entegrasyon çalışması olacaktır. Fakat bu entegrasyon ile belli bir altyapı hazır olduğundan o çalışmanın daha hızlı gerçekleşeceğini düşünüyorum.

Teşekkür Ederim,
Saygılarımla...
👨🏻‍💻
Latif Bahadır ALTUN
Yazılım Mühendisi

Data Monitoring

Put Event

Put Sensor

Data Analytics

Get Event

Get Sensor

Özetle