.. highlightlang:: us .. _auto_getdata: auto_GetData ============ .. index:: auto_GetData .. us.tag auto_GetData NOTREADYGERMAN Changed590 :ref:`auto_GetData` gibt die Daten der angegebenen Kanäle als Matrix zurück. Die Funktion liefert die Daten nur für numerische Kanäle. .. function:: rmData = auto_GetData(ssNetCDFFileName, svVarName) rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName) rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName, bFilter) rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName, bFilter, bRemoveMissingValues) rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName, bFilter, bRemoveMissingValues, rsStart, rsCount) .. us.return **Returnwert** *rmData* ist eine reelle Matrix. Für jeden Kanalnamen enthält die Matrix eine Spalte. Falls die Datei nicht geöffnet werden kann, oder der erste Kanal im Parameter in der NC-Datei nicht existiert, liefert die Funktion einen Vektor mit den Werten 0. Die Länge des Vektors entspricht der Anzahl der Kanalnamen im Parameter *svVarName*. Falls der erste Kanal existiert, aber weitere Kanäle nicht in der NC-Datei vorhanden sind, liefert die Funktion für die ungültigen Kanäle in der Ergebnismatrix den Wert 0 zurück. Bei allen anderen Fehlern gibt die Funktion den skalaren Wert ``ERROR_VALUE`` zurück. .. us.params **Parameter** .. uparam:: ssNetCDFFileName *ssNetCDFFileName* ist der vollständige Name einer netCDF-Datei (:file:`.nc`). oder ein leerer String. Bei einem leeren String muss der Parameter *ncid* eine gültige ncid enthalten. .. uparam:: ncid *ncid* ist die Zugriffsnummer einer NC-Datei. Die Zugriffsnummer wird von der Funktion :ref:`nc_open` zurück gegeben. Falls der Parameter *ssNetCDFFileName* einen gültigen Dateinamen enthält, kann für *ncid* -1 übergeben werden. .. uparam:: svVarName *svVarName* ist ein Vektor mit Kanalnamen. .. uparam:: bFilter *bFilter* legt fest, ob der Recordfilter verwendet werden soll. Defaultwert ist FALSE (0). .. uparam:: bRemoveMissingValues *bRemoveMissingValues* legt fest ob alle Werte oder nur die gültigen Werte zurück gegeben werden sollen. Defaultwert ist TRUE (1). .. uparam:: rsStart *rsStart* ist ein skalarer Wert, der die Startpositionen für das Lesen der Daten festlegt. Die Startpositionen beginnen bei 0. Defaultwert ist 0. .. uparam:: rsCount *rsCount* legt die Anzahl der zu lesenden Werte fest. Falls die Anzahl größer als die Anzahl der verfügbaren Werte ist, wird die Anzahl korrigiert. Die Anzahl muss mindestens 1 betragen. Defaultwert ist die Anzahl der Datenpunkte im Kanal. .. seealso:: :ref:`uberblick-automatisierung-der-diagrammerstellung`, :ref:`auto_ImportData`, :ref:`auto_LoadDataset`, :ref:`auto_xy_CreateDataset`, :ref:`nc_varget` :sub:`id-1879209`