.. highlightlang:: us .. index:: NC_ExportData .. _nc_exportdata: NC_ExportData ============= .. us.tag NC_ExportData GERMAN nc.tools New593 Changed5147 Changed5400 Changed5603 :ref:`NC_ExportData` konvertiert netCDF-Dateien (.nc) oder UniPlot-Datendateien (.nc2) in ein anderes Dateiformat. .. function:: svExportNames = NC_ExportData(svNCNames, ssType, ssOutDir, svSep, ssMissing, bOverwrite) svExportNames = NC_ExportData(ncid, ssType, ssOutDir, svSep, ssMissing, bOverwrite) svExportNames = NC_ExportData(svNCNames, ssType, obj) svExportNames = NC_ExportData(ncid, ssType, obj) .. us.return **Returnwert** Ist ein String-Vektor mit den vollständigen Dateinamen der exportierten Dateien oder einen leerer String im Fehlerfall. .. us.params **Parameter** .. uparam:: svNCNames *svNCNames* ist ein Stringvektor mit Datendateinamen. Die Namen der Export-Dateien werden aus den NC-Dateinamen gebildet. Die Dateinameserweiterung hängt vom Exporttyp ab. .. uparam:: ncid *ncid* ist ein Vektor von Zugriffsnummern, die von einem erfolgreichen Aufruf der Funktionen :ref:`nc_create` oder :ref:`nc_open` geliefert wurden. .. uparam:: ssType *ssType* ist ein String aus der ersten Spalte der folgenden Tabelle: .. list-table:: :header-rows: 1 * - Typ - Extension - Bedeutung * - CSV - .csv oder .txt - Textdatei ohne Kopfdaten mit wählbarem Trennzeichen (Komma, Semikolon, Tab) * - CSV-UTX - .utx - Text-Datei mit Kopfdaten im UTX-Format * - XLS - .xls - Excel-Datei ohne Kopfdaten mit maximal 16384 Zeilen und 255 Kanäle * - XLS-UTX - .xls - Excel-Datei mit Kopfdaten im UTX Format mit maximal 16384 Zeilen, 255 Kanäle * - XLSX - .xlsx - Excel-Datei mit Kopfdaten ab Excel 2007 * - XLSX-NOHEADER - .xlsx - Excel-Datei ohne Kopfdaten ab Excel 2007 * - XLSX-UTX - .xlsx - Excel-Datei mit Kopfdaten im UTX Format ab Excel 2007 * - TDM - .tdm - TDM-Datei (National Instruments Format) * - NC - .nc - netCDF-Datei. * - NC-UP - .nc2 - UniPlot-Datendatei. * - MATLAB - .mat - MATLAB Format 5 * - MDF4 - .mf4 - ASAM MDF Format 4 .. uparam:: obj *obj* ersetzt die Parameter 3, 4, 5 und 6. *obj* ist ein Objekt mit den folgenden Elementen: .. list-table:: :header-rows: 1 * - Name - Bedeutung * - obj.ssFieldSeparator - Feldseparator, z. B. Semikolon (``;``). Defaultwert ist die Ländereinstellung. * - obj.ssDecimalSeparator - Dezimalseparator: ``.`` oder ``,``. Defaultwert ist die Ländereinstellung. * - obj.ssMissing - Text für ungültige Werte, Defaultwert ist ``"*****"``. * - obj.bOverwriteFile - TRUE (1): Zieldatei wird ohne Rückfrage überschrieben. Defaultwert ist TRUE (1). * - obj.svChannel - Leerer String ``""`` um alle Kanäle zu Exportieren, oder ein Vektor mit Kanalnamen. Kanäle, die nicht in der NC-Datei vorhanden sind, werden trotzdem erzeugt und mit missing aufgefüllt. Defaultwert ist ein leerer String (``""``). * - obj.ssOutDir - Zielverzeichnis für Export-Dateien. Beim leeren String wird die Datei in das Verzeichnis der NC-Datei kopiert. Defaultwert ist ein leerer String (``""``). Wenn ein Element nicht definiert ist, wird der Defaultwert verwendet. .. uparam:: ssOutDir Ist der Name eines gültigen Verzeichnisses oder ein leerer String. Bei einem leeren String werden die Exportdateien im Verzeichne der NC-Dateien gespeichert. .. uparam:: svSep Ist ein Stringvektor mit zwei Elementen. Das erste Element enthält das Feldtrennzeichen, das zweite Element das Dezimaltrennzeichen. Beispiele: ``[";", ","]`` oder ``["\t", "."]`` oder ``[",", "."]``. Wird nur bei CSV-Dateien ausgewertet. .. uparam:: ssMissing Text für die Darstellung von ungültigen Werten bei Text- und Excel-Dateien. .. uparam:: bOverwrite Falls *bOverwrite* TRUE (1) ist, werden vorhandene Export-Dateien ohne Meldung überschreiben. .. us.example **Beispiel** :: def MyCSVExport() { svFiles = GetOpenFileName("", "Data Files (*.nc;*.nc2)|*.nc;*nc2|", 1, 1); if (svFiles[1] == "") { return; } obj = [.] ssType = "XLSX"; obj.ssOutDir = "d:/"; obj.ssMissing = ""; obj.ssFieldSeparator = ","; obj.ssDecimalSeparator = "."; obj.bOverwrite = TRUE; obj.svChannel = ["Lst", "EngPwr", "Drehzahl", "PME"]; ShowWaitCursor(TRUE); svReturn = NC_ExportData(svFiles, ssType, obj); ShowWaitCursor(FALSE); return svReturn; } .. us.history **History** .. list-table:: :header-rows: 1 * - Version - Beschreibung * - R2014.3 - Export format XLSX-NOHEADER zugefügt. * - 5.14.7 - Neuer Parameter *obj*. * - 5.9.3 - Neu. .. seealso:: :ref:`uberblick-netcdf-dateien`, :ref:`dateidaten-exportieren`, :ref:`nc_create` :sub:`id-883032`