XYReload

XYReload loads data.

bool = XYReload(hData)
bool = XYReload(hData, nOptions)
bool = XYReload(hData, nOptions, ncid)

Return Value

bool

Parameters

hData

The handle of a dataset created with XYCreate or TYCreate.

nOptions
XY_RELOAD_UPDATE (0) Reload data if necessary.
XY_RELOAD_CLIP (1) Reload data only for the x-axis range of the diagram.
XY_RELOAD_ALL (2) Reload all data points.
XY_RELOAD_FORCERELOAD (4) Force reload data.
ncid

ncid is a data file handle (see nc_open).

Comment

The function opens the data file (*.nc2) and loads the data for the displayed x-range. If the file is not found in the specified directory, UniPlot tries to find the file in the following directories:

  • Directory of the IPW file.
  • Directory specified in Tools=>More Options “Data Import and Data Browser”, key “netCDF Data File Directory”.

If the file cannot be located an error message is written to the event window.

History

Version Description
R2012 (5.40.0) Depending on the diagram section, the function loads data from the reduced data file or the non reduced data file.
5.20 New optional parameters nOptions and ncid.
5.9 New.

id-1004157