netCDF-SDK

Hier wird beschrieben, wie sie die von UniPlot verwendeten Messdaten-Dateien mit C-Programmen (oder Programmen mit C-Anbindung) lesen und schreiben können.

Inhalt

Die folgenden Dateien müssen mit Ihrer Anwendung installiert werden. Diese Dateien können Sie einem installierten UniPlot ab Version R2011 entnehmen. Es können die 32-Bit oder die 64-Bit Version oder beide Versionen getrennt verwendet werden. Die Datei license.txt finden Sie im Verzeichnis UniPlot\samples\netCDF-SDK.

rs_nc.dll
rs_vcrt.dll
rs_updf.dll
rs_xlib.dll
rs_mdf.dll
license.txt

Sonstige Dateien aus dem Verzeichnis UniPlot\samples\netCDF-SDK:

ncread.c            - Ein einfaches Beispiel-Programm zum Lesen.
ncwrite.c           - Ein einfaches Beispiel-Programm zum Schreiben.
rs_updf_nc.lib      - Die 32-Bit Import-Library.
x64\rs_updf_nc.lib  - Die 64-Bit Import-Library.
up-nc.h             - Die Header-Datei.

Einige Anmerkungen

• Das UniPlot-netCDF-SDK verwendet die API von netCDF 2.4.

  http://www.unidata.ucar.edu/software/netcdf/old_docs/really_old/guide_toc.html

• Die von UniPlot verwendeten netCDF-Dateien können in drei verschiedenen Formaten vorliegen:

  1. Das “klassische” netCDF-Format wie im Link oben beschrieben. Dateigröße maximal 2 GBytes. Die ersten drei Zeichen der Datei sind “CDF”.

  2. Eine speziell für UniPlot abgewandelte Form mit Intel-Byteorder (Little Endian). Diese Dateien können von Standard-netCDF-Librarys nicht gelesen werden. Dateigröße ebenfalls maximal 2 GBytes. Die ersten drei Zeichen der Datei sind “CDH”.

  3. Ein spezielles UniPlot-Format, dass von dem netCDF-Format nur noch die API verwendet. Es unterstützt Kompression und schnelles Löschen und Zufügen von Kanälen und Attributen. Die ersten drei Zeichen der Datei sind “UPD”. Diese Dateien sind wie ein Dateisystem aufgebaut. Die Informationen befinden sich in Sektoren, in denen sich Daten und Inhaltsverzeichnisse befinden. Es hat einige Ähnlichkeiten mit dem auf HDF aufbauenden netCDF-4, ist aber ein eigenes, unabhängiges Dateiformat und wesentlich einfacher als netCDF-4.

     Dateigröße maximal 1 TB, Kanallänge in dieser Version 2^31-1 Datenpunkte.

• Falls Sie einen Microsoft C-Compiler verwenden, können Sie das Beispielprogramm mit:

  cl ncread.c rs_updf_nc.lib
  

  übersetzen. Die Pfade für den C-Compiler müssen richtig gesetzt sein.

  Starten Sie das Programm mit:

  ncread test.nc
  

  Es gibt die ersten 10 Datenpunkte aller Kanäle der Datendatei aus. Testdateien in verschiedenen Formaten können Sie mit UniPlot erstellen.

• Anstatt die Import-Library rs_updf_nc.lib zu verwenden, können Sie die Funktionen auch über LoadLibrary, (LoadLibraryEx, GetModuleHandle) und GetProcAddress dynamisch laden.

• Bei einigen Ursprungsformaten (z. B. INCA-MDF) konvertiert UniPlot die Dateien optional nicht komplett in einem Zug in das netCDF-Format. In diesen Dateien sind zwar alle globalen Attribute, die Definition der Kanäle sowie die Attribute der Kanäle enthalten, jedoch sind die Daten nicht von allen Kanälen enthalten.

  Ob die Daten des Kanals vorhanden sind, kann über das Kanal-Attribut _nc_dl_loaded gleich 0 oder 1 festgestellt werden. Über das globale Attribut _nc_dl_loadcount kann die Anzahl der geladenen Kanäle ermittelt werden.

History

Version	Beschreibung
1.1 (25.03.2011)	Schreiben zugefügt.
1.0 (21.03.2011)	Erste Version.

Kontakt

Bei Fragen wenden Sie sich an:

Uniplot Software GmbH

Am Seekanal 16

15834 Rangsdorf

Germany

Tel.: ++49 (0)33708/73754

Fax: ++49 (0)33708/73755

E-Mail: support@uniplot.de

Internet: http://www.uniplot.de

_id-1961936