Dokumentation

Letzte Änderung am 08.08.2019

Was ist enthalten?

Das LineMetrics Matlab API SDK ermöglicht es Ihnen historische Daten aus der LineMetrics Cloud abzufragen. Andere Funktionalitäten der LineMetrics REST API wie das herunterladen von Objektdaten, erstellen von Objekten oder schreiben von Daten in die Cloud wird im Moment nicht unterstützt.

Wie wird dieses Paket installiert?

• Laden Sie die komprimierte Datei unter Download herunter.
• Entpacken Sie die Datei woauch immer es Ihnen passend erscheint.
• Fügen Sie den Pfad zu der Datei zu Ihren Matlab Suchpfaden hinzu:

addpath('/path/to/the/folder/of/the/m/file')

Beispiel

Verbinden zur Cloud

Zuerst müssen wir uns mit der Cloud verbinden. Dazu benötigen Sie ihre Client ID und Ihr Client Secret.
a = LmApi('your_client_id','your_client_secret')
Die folgende Ausgabe sollte ungefähr so aussehen:

LineMetrics API access token has been retrieved.
This token is expiring in one hour.
Then you have to get a new token.

a =

LmApi with properties:

ClientId: 'XXX'
ClientSecret: 'XXX'
AccessToken: 'XXX'
ApiOptions: [1×1 weboptions]

Die Verbindung zur Cloud wird nach einer Stunde geschlossen. Dann muss der obige Schritt erneut ausgeführt werden.

Daten herunterladen

Nun sind wir bereit Daten aus der Cloud herunterzuladen. Dazu benötigen Sie die Object ID und den API Alias des Messpunktes, den Sie herunter laden möchten.
data = a.loadData('2019-07-01 00:00','2019-08-06 12:00','object_id','api_alias')
Sie sollten dann ungefähr diese Ausgabe erhalten:

timeseries

Common Properties:
Name: 'your_object_id/your_api_alias'
Time: [52561x1 double]
TimeInfo: [1x1 tsdata.timemetadata]
Data: [1x1x52561 double]
DataInfo: [1x1 tsdata.datametadata]

More properties, Methods

Nun können Sie die Daten darstellen:
plot(data)

Kontakt

Falls Sie Probleme beim Anwenden der bereitgestellten Software haben oder Anregungen zur Verbesserung einbringen möchten, zögern Sie nicht das LineMetrics Team zu kontaktieren. Wir freuen uns übere Ihre Rückmeldungen.