NC_ExportDataΒΆ

NC_ExportData converts UniPlot data files (.nc, .nc2) into another data format.

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)

Return Value

Is a string vector of the exported files. In case of an error, the function returns an empty string.

Parameters

svNCNames

svNCNames is a string vector with NC data file names.

ncid

ncid is a vector of ncids returned by nc_create or nc_open.

ssType

ssType is a scalar string with a value from the first column of the following table:

Type Extension Description
CSV .csv oder .txt Text file without header data with one of the following field separators (comma, semicolon, Tab)
CSV-UTX .utx Text file with header data in the UTX format
XLS .xls Excel file without header data with a maximum of 16384 rows and 255 channels
XLS-UTX .xls Excel file with header data in the UTX with a maximum of 16384 rows and 255 channels
XLSX .xlsx Excel format with header data in Excel 2007 format
XLSX-NOHEADER .xlsx Excel format without header data in Excel 2007 format
XLSX-UTX .xlsx Excel format with header data in the UTX format in Excel 2007 format
TDM .tdm TDM format (National Instruments Format)
NC .nc netCDF format.
NC-UP .nc2 UniPlot format.
MATLAB .mat MATLAB Format 5
obj

obj is a replacement for the parameters 3, 4, 5 and 6. obj is an object with the following elements:

Element Description
obj.ssFieldSeparator Field separator, e. g. semicolon (;). Default value is the country setting.
obj.ssDecimalSeparator Decimal separator: . or ,. Default value is the country setting.
obj.ssMissing Text for invalid values, Default value is "*****".
obj.bOverwriteFile TRUE (1): Target file will be overwritten. Default value is TRUE (1).
obj.svChannel If set to an empty string "" all channels will be exported; or a list with channel names. Channels, missing in the nc file will be created in the export file with missing values. Default value is an empty string ("").
obj.ssOutDir Export directory. If set to an empty string, the export file will be saved in the directory of the nc file. Default value is an empty string ("").

If an element is not set in the object, the default value will be used.

ssOutDir

Is the name of a output directory or an empty string. If ssOutDir is an empty string, the exported files will be saved in the directory of the NC source files.

svSep

Is a string vector with two elements. The first element is the field separator and the second element is the decimal separator: Examples: [";", ","] or ["\t", "."] or [",", "."]. Only used with CSV export.

ssMissing

Is a text to display invalid numbers. Only used with CSV and Excel export.

bOverwrite

If bOverwrite is TRUE (1), existing export files will be replaced.

Example

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", "Speed", "PME"];

   ShowWaitCursor(TRUE);
   svReturn = NC_ExportData(svFiles, ssType, obj);
   ShowWaitCursor(FALSE);
   return svReturn;
}

History

Version Description
R2014.3 Export format XLSX-NOHEADER added.
5.14.7 New parameter obj.
5.9.3 New.

id-883032