2.7.51 impNetCDFEx

1 Menu Information
2 Brief Information
3 Additional Information
4 Command Line Usage
5 X-Function Execution Options
6 Variables
7 Description
- 7.1 Details on Some Dialog Options
8 Examples
9 Related X-Functions

Menu Information

Data: Import from File: NetCDFEx (NC)

Brief Information

Import netCDF file. It supports the file version lower than 4.01.

Additional Information

Minimum Origin Version Required: 8.1 SR0

Command Line Usage

impNetCDF fname:="RUC.NC";

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display Name	Variable Name	I/O and Type	Default Value	Description
File Name	fname	Input string	fname$	Specify the filename(s) of the file(s) to be imported. In the dialog, click the browse button beside the list box to open one or more files and the filenames will be listed in the box.
File Info And Data Selection	trfiles	Input TreeNode	<unassigned>	This is used to select the desired data channels. See more details in Description table.
Output	orng	Output Range	<active>	Specifies the range for the imported data. See the syntax here.
Header Info	trheader	Output TreeNode	<unassigned>	This is for outputting the header information, which is hidden from the GUI. Users are not advised to use this variable.
Import Filter	trFilter	Input TreeNode	<optional>	This is the TreeNode for the import filter, which is hidden from the GUI. Users are not advised to use this variable.

Description

The Network Common Data Form (NetCDF) is a set of software libraries and data formats. These self-describing and machine-independent formats support the creation, access, and sharing of array-oriented scientific data. And it is platform independent.

This X-Function is used for importing NetCDF data files, whose version should be lower than 4.01. This X-Function supports multi-files importation. When a NetCDF file is imported, there will be at least one work book or one matrix book created. Workbooks are used to store one dimension datasets; while matrix books are used for storing datasets with two or more dimensions datasets. In the latter case, different dimensions of a dataset are saved in different channels in matrix sheets.

Details on Some Dialog Options

File Info And Data Selection (trfiles)

This variable is a treenode. It shows file information and allows you to choose the channels to import. The name of each sub-treenode is the name of the corresponding file. Under each sub-treenode, the file size and any available data are listed. The data are sorted by dimensions.

Examples

Suppose you have a netcdf file, C:\netcdf_test.nc. It has three 2D variables and one 3D variable. Performing the following steps will import all the variables in it into a new workbook in Origin.

Select Data: Import from File: NetCDFEx(NC)... from the Origin menu. This opens the NetCDF dialog.
Go to C:\ and select netcdf_test.nc. Then click the Add File(s) button. Make sure that the Show Options Dialog check box is selected.
Click the OK button to close this dialog box. The impNetCDFEx dialog should be opened.
In the File Info And Data Selection: netcdf_test: DataSelection branch, select all the check boxes.
Change the Output to <new>.
Click the OK button. The data is imported to a matrix book and a workbook.