DS_SetDataSource¶
DS_SetDataSource schreibt den Datendateinamen und die Kanalnamen eines Datensatzes in die „Datasource“-Map des Datensatzes.
-
hMap = DS_SetDataSource(hData, ssNetCDFName, svChannels)
-
hMap = DS_SetDataSource(hData, ssNetCDFName, svChannels, options)
Returnwert
Die „Datasource“-Map des Datensatzes oder 0, wenn ein Fehler aufgetreten ist.
Parameter
-
hData
hData ist die Zugriffsnummer eines Datensatzes.
-
ssNetCDFName
ssNetCDFName ist der vollständige Name einer vorhandenen UniPlot-Datendatei (.nc oder .nc2).
-
svChannels
svChannels ist ein Vektor mit Kanalnamen.
-
options
options ist ein optionales Objekt.
Kommentar
Falls die Funktion mit 3 Parametern aufgerufen wurde, werden folgende Items erzeugt:
NCFile |
DatasetType |
Channel |
Falls ssNetCDFName geöffnet werden kann, werden zusätzlich folgende Items erzeugt:
NCFileTime | |
Origin | |
OriginTime | |
units | |
CycleInfo | Falls in der NC-Datei vorhanden. |
NumberOfPointsSource | |
DataFilter |
Falls die Funktion mit 4 Parametern aufgerufen wurde und options.ncid ungleich -1 ist, wird diese ncid zum Zugriff auf die netCDF-Datei verwendet.
Falls options weitere Items enthält, werden Sie in die Datensatz-Map geschrieben. Es werden dabei die aus der netCDF-Datei gelesenen Attribute überschrieben.
Folgende Items können bei Bedarf gesetzt werden:
FirstPoint |
NumberOfPoints |
AutoReload |
XSort |
Beispiel
def test_DS_SetDataSource()
{
if (version(1) < 5200) return;
<hDoc, hPage> = _UT_CreateEmptyPage();
hLayer = LayerCreate();
PageAddLayer(hPage, hLayer);
ssFile = GetRootDirectory() + "samples\\cycles.nc2";
hData = TYCreate("test");
LayerAddDataset(hLayer, hData);
DS_SetDataSource(hData, ssFile, "pzyl_1");
XYReload(hData, XY_RELOAD_UPDATE);
DS_SetValue(hData, "AutoReload", FALSE);
LayerAutoScale(hLayer);
PageReplot(hPage);
n = XYGetNumberOfPoints(hData);
if (_g().unit_test_cleanup) {
DocDestroy(hDoc);
}
if (n <= 0) {
error();
}
}
test_DS_SetDataSource();
History
Version | Beschreibung |
---|---|
5.20 | Neu. |
Siehe auch
Überblick Datendatei-Informationen für Datensätze, XYCreate, DS_SetValue, DS_RemoveValue, XYReload, XYClip
id-1238667