liladata: Erstellt ein Objekt der Klasse 'liladata'
In matsei/lilatools: Reading files in LILA format

Description Usage Arguments Details Value See Also Examples

View source: R/liladata_class.R

Die Klasse ermöglicht das Verarbeiten Daten aus Dateien im LILA-Format. Insbesondere werden die gesamten Metainformationen in der Klasse beibehalten.

1	liladata(data, meta)

`data`	data.frame enthält die tatsächlichen Werte des Datensatzes
`meta`	data.frame mit den Metainformationen

Die Lese-Funktionen von LILA-Dateien erstellen ein Objekt der S3-Klasse liladata. Dieses enthält alle aus den LILA-Dateien ausgelesenen Daten. Für die Weiterverarbeitung kann das Objekt mit as.data.frame in ein data.frame umgewandelt werden. Dieser Weg ist aber nicht empfohlen, da LILA-Dateien üblicherweise umfangreiche Meta-Informationen haben, die für die gewünschte Analyse nicht erforderlich sind. Daher sollte zunächst eine Auswahl der erfordelrichen Daten mit select.liladata erfolgen.

Intern trennt die Klasse die Daten der Zeitreihen von den Metainformationen. Dadurch soll der Speicherbedarf minimiert werden, was bei großen Datensätzen relevant werden kann. Daher enthält die Klasse zwei Listenelemente mit den Namen: data und meta. Diese können, wie von Listen gewohnt über '$data' oder '$meta' aufgerufen werden. Die Daten im data-Listenelement sind als data.frame oder tibble abgelegt mit den Spalten:

time: die Zeitschritte,
id: eine eindeutige Kennzeichnung eines jeden Werteblocks und
value: die jeweiligen Werte

Die Metainformationen im meta-Listenelement sind ebenfalls als data.frame oder tibble abgelegt. Dort ist ebenfalls die id enthalten, mit der die Metainformationen den Werteblöcken eindeutig zugeordnet werden kann. Als weitere Informationen müssen mindestens die folgenden Spalten enthalten sein, wie dies für das LILA-Format definiert ist:

station
datenart
dimension
zeitintervall

Zusätzlich sind beliebig viele weitere Spalten möglich.

Eine Veränderung der id ist nicht zu empfehlen, und sollte wenn, dann sowohl in data als auch in meta erfolgen. Normalerweise ist eine Manipulation auch nicht erforderlich. Jegliche Veränderung und Veränderung der Daten in R sollte erst nach einer Auswahl und Umwandlung in ein data.frame oder tibble erfolgen. Dies macht die Analyse ohnehin einfacher.

Objekt der Klasse liladata

Other liladata_methods: as.data.frame.liladata, merge_liladata, select.liladata

# empty object
liladata()

# example object
liladata(data=data.frame(id="1-1",
                         time=c("09.09.2019 00:00", "09.09.2019 01:00", "09.09.2019 02:00",
                                "09.09.2019 03:00", "09.09.2019 04:00", "09.09.2019 00:50"),
                         values=c(0.9, 0.9, 0.9, 0.9, 0.8, 0.8)),
         meta=data.frame(id='1-1', station="Rebbelroth", gewaesser="Agger",
                         stationsnummer=01320010, stationskennung='REBR',
                         datenart='Q',dimension='cbm/s', datenbezug='GTS',
                         zeitintervall='01:00', datentyp='M',
                         datenursprung='vhs', flaeche=109.860, flusskilometer=63.693,
                         vorhersagezeitpunkt='08.09.2019 13:00',
                         kommentar='Abfluss Vorhersage',
                         austauschkennung='RP_01320010-qvhs-d01-201908270700'
                         )
                         )