WriteADCPNetCDF

Basisinformationen

Funktionsname

writeADCPNetCDF.m

Version

1.0

Beschreibung

Juli 2015

Stichworte

Schiffgestützte ADCP-Querprofilmessungen; Profil; TracetoryProfile; CF-konforme NetCDF;

Kurzbeschreibung

Die Funktion writeADCPNetCDF schreibt schiffsgestützte ADCP-Querprofilmessungen in eine CF-konforme NetCDF-Datei im Feature Type "TrajectoryProfile". Aufgerufen wird die Funktion durch das Skript adcp2netcdf.

Eingabe

1. adcp: ADCP-Daten, Array von Strukturen mit einem Element pro Transekt (siehe nachstehend)
2. zrefmode: vertikales Bezugsniveau (siehe ADCP-NetCDF Vertikalkoordinate)
3. NetCDF-Dateiname, String

Eingabe ADCP-Daten

%  numel( adcp ) = number of transects
%
%   size( adcp(k).numens )         = [1, 1]                   % number of ensembles in x/y reference plane for each trajectory
%   size( adcp(k).numcells )       = [1, 1]                   % number of depth cells of the vertical grid (bins)
%   size( adcp(k).filename )       = ...                      % transect filename only, without path
%
%   size( adcp(k).cellsize )       = [1, 1]                   % cell size
%   size( adcp(k).deploydepth )    = [1, 1]                   % Xducer deployment depth
%   size( adcp(k).rangefirstcell ) = [1, 1]                   % distance between Xducer and first cell
%
%   size( adcp(k).platform)        = [1, 1]                   % string, platform name, ship
%   size( adcp(k).survey)          = [1, 1]                   % string, survey name
%
%   size( adcp(k).minlat )         = [1, 1]                   % minimum latitude, decimal degree
%   size( adcp(k).maxlat )         = [1, 1]                   % maximum latitude, decimal degree
%   size( adcp(k).minlon )         = [1, 1]                   % minimum longitude, decimal degree
%   size( adcp(k).maxlon )         = [1, 1]                   % maximum longitude, decimal degree
%
%   size( adcp(k).xresolution )    = [1, 1]                   % average distance between ensembles, meters
%   size( adcp(k).yresolution )    = [1, 1]                   
%
%   size( adcp(k).coord.date )     = [1, adcp(k).numens]      % Matlab date numbers
%
%   size( adcp(k).coord.lat )      = [1, adcp(k).numens]      % latitude, decimal degree
%   size( adcp(k).coord.lon )      = [1, adcp(k).numens]      % longitude, decimal degree
%
%   size( adcp(k).coord.x )        = [1, adcp(k).numens]      % UTM or GK, meters, based on GPS geographical coordinates
%   size( adcp(k).coord.y )        = [1, adcp(k).numens]
%   size( adcp(k).coord.UTMzone )  = [1, 1]                   % string
%
%   size( adcp(k).coord.path )     = [1, adcp(k).numens]      % path along track [m]
%
%   size( adcp(k).coord.orient_flag = [1]                     % flag of trajectory orientation (for visualisation purposes)
%
%   size( adcp(k).var.waterlevel ) = [1, adcp(k).numens]      % water level elevation in NHN
%   size( adcp(k).var.btrange )    = [1, adcp(k).numens]      % average bottom track range, meters
%
%   size( adcp(k).var.vel.mag )    = [adcp(k).numcells, adcp(k).numens]  % velocity magnitude [m/s]
%   size( adcp(k).var.vel.vel_x    = [adcp(k).numcells, adcp(k).numens]  % velocity x-component [m/s]
%   size( adcp(k).var.vel.vel_y    = [adcp(k).numcells, adcp(k).numens]  % velocity y-component [m/s]
%   size( adcp(k).var.vel.vel_z    = [adcp(k).numcells, adcp(k).numens]  % velocity z-component (vertical ADCP velocity) [m/s]
%
%   size( adcp(k).var.Q )          = [adcp(k).numcells, adcp(k).numens]  % Discharge Data [m3/s]
%
%   size( adcp(k).var.conc.ssc )   = [adcp(k).numcells, adcp(k).numens]  % suspended sediment concentration (SSC) [kg/m3]
%
%   size( adcp(k).var.flux )       = [adcp(k).numcells, adcp(k).numens]  % Suspended Sediment Transport [kg/s]
%   size( adcp(k).var.flux_x )     = [adcp(k).numcells, adcp(k).numens]  % Suspended Sediment Transport x-component [kg/s]
%   size( adcp(k).var.flux_y )     = [adcp(k).numcells, adcp(k).numens]  % Suspended Sediment Transport y-component [kg/s]
%   size( adcp(k).var.flux_z )     = [adcp(k).numcells, adcp(k).numens]  % Suspended Sediment Transport z-component (vertikal)[kg/s]

Aufrufende Unterfunktionen

• mdate2netcdf: Konvertierung MATLAB Datenumbers in String-Format und fügt UTC-Zeitzone hinzu
• mdatestrtz: Konvertierung der MATLAB Datenumbers in Sekunden seit dem Referenzdatum mit UTC-Zeitzone

Ausgabedatei

• Schreibt ADCP-NetCDF-Datei (.nc), z.B. "Weser_090622_Rechtenfleth_depth2D.nc"

Methode

Eine detaillierte Beschreibung der Methodik ist unter ADCP-NetCDF zu finden.

Programmiersprache

MATLAB (2014b)

Originalversion

S.Grünler

Programmpflege

S.Grünler

Dokumentation/Literatur

siehe auch ...\K2\Naturuntersuchungen\0_Geraete_Standardsoftware\2_Natur\2_Software\MATLAB\NetCDF\

---

zurück zu Software Naturmessungen

---

Strukturübersicht