Abbildung der Runtime Funktion

Diese Dokumentation beschreibt, wie Daten mithilfe der Analytics Data Exchange API aus dem Analytics-Format ausgelesen werden können.

Lizenz

Für das Lesen von Daten aus dem TwinCAT-Analytics-Format wird eine Lizenz für die „TwinCAT 3 Analytics Runtime“ oder „TwinCAT 3 Analytics Runtime Base“ benötigt. Die Data Exchange API kann mit einer 7-Tage Lizenz getestet werden.

Erzeugen und Konfigurieren einer Datenquelle:

Factory = SourceFactory()

Builder = Factory.FromLiveStream(Broker, 1883) 

Builder = Factory.FromFile(FilePath)

Die verschiedenen Builder stellen unterschiedliche Methoden zur Konfiguration bereit. Symbole können über die Methoden „WithSymbol“, „WithName“ oder „WithRegex“ hinzugefügt werden:

TestValue = UInt64("Variables.nGrowSteady")
Builder.WithSymbol(TestValue)

Builder.WithName("TestValues.nGrowSteady")
Builder.WithRegex("Variables.f", 0, RegexSymbolFilter.IncludeChilds)

Ist der Builder vollständig konfiguriert wird über die Build-Methode eine neues Sink angelegt. Die Datenabfrage startet durch Aufrufen der Read-Methode. Als Parameter wird ein Callback-Methode übergeben. Enthält das über geben Sample keine Symbole wurden bereits alle Daten ausgelesen. Gibt die Callback-Methode einen Wert ungleich 0 zurück wird das Auslesen abgebrochen.

def Callback(sample : ISample) -> int:
    if sample.Symbols() is not None:
        print(f'Stamp = {sample.Timestamp()}, {sample.Symbols()[0].SymbolName()} = {sample.Symbols()[0].Value}')
        Values.append(sample.Symbols()[0].Value)
        Stamps.append(DateTimeToFileTime(sample.Timestamp()))
        if len(Stamps) >= SampleCount:
            return False
    return True

Source.Read(Callback)

Beispiel:

Das vollständige Beispiel finden Sie hier: SampleRuntime.zip