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

// File created from "script\datasets\rs_dsrc.ic".

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);

    if (XYGetNumberOfPoints(hData) <= 0) {
        error();
    }

//    DocDestroy(hDoc);
}

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