Home

Context Navigation

netcdf.f90 @ 397

Last change on this file since 397 was 392, checked in by raasch, 15 years ago

New:
---

Adapted for machine lck
(mrun, mbuild, subjob)

bc_lr/bc_ns in most subroutines replaced by LOGICAL variables bc_lr_cyc,
bc_ns_cyc for speed optimization
(check_parameters, diffusion_u, diffusion_v, diffusion_w, modules)

Additional timestep criterion in case of simulations with plant canopy (timestep)

Check for illegal entries in section_xy|xz|yz that exceed nz+1|ny+1|nx+1
(check_parameters)

Clipping of dvrp output implemented. Default colourtable for particles
implemented, particle attributes (color, dvrp_size) can be set with new
parameters particle_color, particle_dvrpsize, color_interval,
dvrpsize_interval (init_dvrp, data_output_dvrp, modules, user_data_output_dvrp).
Slicer attributes (dvrp) are set with new routine set_slicer_attributes_dvrp
and are controlled with existing parameters slicer_range_limits.
(set_slicer_attributes_dvrp)

Ocean atmosphere coupling allows to use independent precursor runs in order
to account for different spin-up times. The time when coupling has to be
started is given by new inipar parameter coupling_start_time. The precursor
ocean run has to be started using new mrun option "-y" in order to add
appendix "_O" to all output files.
(check_for_restart, check_parameters, data_output_2d, data_output_3d,
data_output_profiles, data_output_ptseries, data_output_spectra,
data_output_tseries, header, init_coupling, modules, mrun,
parin, read_var_list, surface_coupler, time_integration, write_var_list)

Polygon reduction for topography and ground plate isosurface. Reduction level
for buildings can be chosen with parameter cluster_size. (init_dvrp)

External pressure gradient (check_parameters, header, init_3d_model, modules,
parin, prognostic_equations, read_var_list, write_var_list)

New topography case 'single_street_canyon' (header, init_grid, modules, parin,
read_var_list, user_check_parameters, user_header, user_init_grid, write_var_list)

Option to predefine a target bulk velocity for conserve_volume_flow
(check_parameters, header, init_3d_model, modules, parin, read_var_list,
write_var_list)

Option for user defined 2D data output in xy cross sections at z=nzb+1
(data_output_2d, user_data_output_2d)

xy cross section output of surface heatfluxes (latent, sensible)
(average_3d_data, check_parameters, data_output_2d, modules, read_3d_binary,
sum_up_3d_data, write_3d_binary)

average_3d_data, check_for_restart, check_parameters, data_output_2d, data_output_3d, data_output_dvrp, data_output_profiles, data_output_ptseries, data_output_spectra, data_output_tseries, init_coupling, init_dvrp, init_grid, init_3d_model, header, mbuild, modules, mrun, package_parin, parin, prognostic_equations, read_3d_binary, read_var_list, subjob, surface_coupler, timestep, time_integration, user_check_parameters, user_data_output_2d, user_data_output_dvrp, user_header, user_init_grid, write_3d_binary, write_var_list

New: set_particle_attributes, set_slicer_attributes_dvrp

Changed:

lcmuk changed to lc to avoid problems with Intel compiler on sgi-ice
(poisfft)

For extended NetCDF files, the updated title attribute includes an update of
time_average_text where appropriate. (netcdf)

In case of restart runs without extension, initial profiles are not written
to NetCDF-file anymore. (data_output_profiles, modules, read_var_list, write_var_list)

Small change in formatting of the message handling routine concering the output in the
job protocoll. (message)

initializing_actions='read_data_for_recycling' renamed to 'cyclic_fill', now
independent of turbulent_inflow (check_parameters, header, init_3d_model)

2 NetCDF error numbers changed. (data_output_3d)

A Link to the website appendix_a.html is printed for further information
about the possible errors. (message)

Temperature gradient criterion for estimating the boundary layer height
replaced by the gradient criterion of Sullivan et al. (1998). (flow_statistics)

NetCDF unit attribute in timeseries output in case of statistic regions added
(netcdf)

Output of NetCDF messages with aid of message handling routine.
(check_open, close_file, data_output_2d, data_output_3d,
data_output_profiles, data_output_ptseries, data_output_spectra,
data_output_tseries, netcdf, output_particles_netcdf)

Output of messages replaced by message handling routine.
(advec_particles, advec_s_bc, buoyancy, calc_spectra, check_for_restart,
check_open, coriolis, cpu_log, data_output_2d, data_output_3d, data_output_dvrp,
data_output_profiles, data_output_spectra, fft_xy, flow_statistics, header,
init_1d_model, init_3d_model, init_dvrp, init_grid, init_particles, init_pegrid,
netcdf, parin, plant_canopy_model, poisfft_hybrid, poismg, read_3d_binary,
read_var_list, surface_coupler, temperton_fft, timestep, user_actions,
user_data_output_dvrp, user_dvrp_coltab, user_init_grid, user_init_plant_canopy,
user_parin, user_read_restart_data, user_spectra )

Maximum number of tails is calculated from maximum number of particles and
skip_particles_for_tail (init_particles)

Value of vertical_particle_advection may differ for each particle group
(advec_particles, header, modules)

First constant in array den also defined as type double. (eqn_state_seawater)

Parameter dvrp_psize moved from particles_par to dvrp_graphics_par. (package_parin)

topography_grid_convention moved from userpar to inipar (check_parameters,
header, parin, read_var_list, user_check_parameters, user_header,
user_init_grid, user_parin, write_var_list)

Default value of grid_matching changed to strict.

Adjustments for runs on lcxt4 (necessary due to an software update on CRAY) and
for coupled runs on ibmy (mrun, subjob)

advec_particles, advec_s_bc, buoyancy, calc_spectra, check_for_restart, check_open, check_parameters, close_file, coriolis, cpu_log, data_output_2d, data_output_3d, data_output_dvrp, data_output_profiles, data_output_ptseries, data_output_spectra, data_output_tseries, eqn_state_seawater, fft_xy, flow_statistics, header, init_1d_model, init_3d_model, init_dvrp, init_grid, init_particles, init_pegrid, message, mrun, netcdf, output_particles_netcdf, package_parin, parin, plant_canopy_model, poisfft, poisfft_hybrid, poismg, read_3d_binary, read_var_list, sort_particles, subjob, user_check_parameters, user_header, user_init_grid, user_parin, surface_coupler, temperton_fft, timestep, user_actions, user_data_output_dvrp, user_dvrp_coltab, user_init_grid, user_init_plant_canopy, user_parin, user_read_restart_data, user_spectra, write_var_list

Errors:

Bugfix: Initial hydrostatic pressure profile in case of ocean runs is now
calculated in 5 iteration steps. (init_ocean)

Bugfix: wrong sign in buoyancy production of ocean part in case of not using
the reference density (only in 3D routine production_e) (production_e)

Bugfix: output of averaged 2d/3d quantities requires that an avaraging
interval has been set, respective error message is included (check_parameters)

Bugfix: Output on unit 14 only if requested by write_binary.
(user_last_actions)

Bugfix to avoid zero division by km_neutral (production_e)

Bugfix for extended NetCDF files: In order to avoid 'data mode' errors if
updated attributes are larger than their original size, NF90_PUT_ATT is called
in 'define mode' enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a
possible performance loss; an alternative strategy would be to ensure equal
attribute size in a job chain. (netcdf)

Bugfix: correction of initial volume flow for non-flat topography (init_3d_model)
Bugfix: zero initialization of arrays within buildings for 'cyclic_fill' (init_3d_model)

Bugfix: to_be_resorted => s_av for time-averaged scalars (data_output_2d, data_output_3d)

Bugfix: error in formatting the output (message)

Bugfix: avoid that ngp_2dh_s_inner becomes zero (init_3_model)

Typographical error: unit of wpt in dots_unit (modules)

Bugfix: error in check, if particles moved further than one subdomain length.
This check must not be applied for newly released particles. (advec_particles)

Bugfix: several tail counters are initialized, particle_tail_coordinates is
only written to file if its third index is > 0, arrays for tails are allocated
with a minimum size of 10 tails if there is no tail initially (init_particles,
advec_particles)

Bugfix: pressure included for profile output (check_parameters)

Bugfix: Type of count and count_rate changed to default INTEGER on NEC machines
(cpu_log)

Bugfix: output if particle time series only if particle advection is switched
on. (time_integration)

Bugfix: qsws was calculated in case of constant heatflux = .FALSE. (prandtl_fluxes)

Bugfix: averaging along z is not allowed for 2d quantities (e.g. u* and z0) (data_output_2d)

Typographical errors (netcdf)

If the inversion height calculated by the prerun is zero, inflow_damping_height
must be explicitly specified (init_3d_model)

Small bugfix concerning 3d 64bit netcdf output format (header)

Bugfix: dt_fixed removed from the restart file, because otherwise, no change
from a fixed to a variable timestep would be possible in restart runs.
(read_var_list, write_var_list)

Bugfix: initial setting of time_coupling in coupled restart runs (time_integration)

advec_particles, check_parameters, cpu_log, data_output_2d, data_output_3d, header, init_3d_model, init_particles, init_ocean, modules, netcdf, prandtl_fluxes, production_e, read_var_list, time_integration, user_last_actions, write_var_list

Property svn:keywords set to Id

File size: 149.8 KB

Line
1	#if defined( __ibmy_special )
2	@PROCESS NOOPTimize
3	#endif
4	SUBROUTINE define_netcdf_header( callmode, extend, av )
5
6	!------------------------------------------------------------------------------!
7	! Current revisions:
8	! ------------------
9	!
10	!
11	! Former revisions:
12	! -----------------
13	! $Id: netcdf.f90 392 2009-09-24 10:39:14Z raasch $
14	!
15	! 359 2009-08-19 16:56:44Z letzel
16	! For extended NetCDF files, the updated title attribute includes an update of
17	! time_average_text where appropriate.
18	! Bugfix for extended NetCDF files: In order to avoid 'data mode' errors if
19	! updated attributes are larger than their original size, NF90_PUT_ATT is called
20	! in 'define mode' enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a
21	! possible performance loss; an alternative strategy would be to ensure equal
22	! attribute size in a job chain.
23	! NetCDF unit attribute in timeseries output in case of statistic
24	! regions added.
25	! Output of NetCDF messages with aid of message handling routine.
26	! Output of messages replaced by message handling routine.
27	! Typographical errors fixed.
28	!
29	! 216 2008-11-25 07:12:43Z raasch
30	! Origin of the xy-coordinate system shifted from the center of the first
31	! grid cell (indices i=0, j=0) to the south-left corner of this cell.
32	!
33	! 189 2008-08-13 17:09:26Z letzel
34	! consistently allow 100 spectra levels instead of 10
35	! bug fix in the determination of the number of output heights for spectra,
36	! +user-defined spectra
37	!
38	! 97 2007-06-21 08:23:15Z raasch
39	! Grids defined for rho and sa
40	!
41	! 48 2007-03-06 12:28:36Z raasch
42	! Output topography height information (zu_s_inner, zw_s_inner) to 2d-xy and 3d
43	! datasets
44	!
45	! RCS Log replace by Id keyword, revision history cleaned up
46	!
47	! Revision 1.12 2006/09/26 19:35:16 raasch
48	! Bugfix yv coordinates for yz cross sections
49	!
50	! Revision 1.1 2005/05/18 15:37:16 raasch
51	! Initial revision
52	!
53	!
54	! Description:
55	! ------------
56	! In case of extend = .FALSE.:
57	! Define all necessary dimensions, axes and variables for the different
58	! NetCDF datasets. This subroutine is called from check_open after a new
59	! dataset is created. It leaves the open NetCDF files ready to write.
60	!
61	! In case of extend = .TRUE.:
62	! Find out if dimensions and variables of an existing file match the values
63	! of the actual run. If so, get all necessary informations (ids, etc.) from
64	! this file.
65	!
66	! Parameter av can assume values 0 (non-averaged data) and 1 (time averaged
67	! data)
68	!------------------------------------------------------------------------------!
69	#if defined( __netcdf )
70
71	USE arrays_3d
72	USE constants
73	USE control_parameters
74	USE grid_variables
75	USE indices
76	USE netcdf_control
77	USE pegrid
78	USE particle_attributes
79	USE profil_parameter
80	USE spectrum
81	USE statistics
82
83
84	IMPLICIT NONE
85
86	CHARACTER (LEN=2) :: suffix
87	CHARACTER (LEN=2), INTENT (IN) :: callmode
88	CHARACTER (LEN=3) :: suffix1
89	CHARACTER (LEN=4) :: grid_x, grid_y, grid_z
90	CHARACTER (LEN=6) :: mode
91	CHARACTER (LEN=10) :: netcdf_var_name, netcdf_var_name_base, &
92	precision, var
93	CHARACTER (LEN=80) :: time_average_text
94	CHARACTER (LEN=2000) :: var_list, var_list_old
95
96	INTEGER :: av, i, id_x, id_y, id_z, j, ns, ns_old, nz_old
97
98	INTEGER, DIMENSION(1) :: id_dim_time_old, id_dim_x_yz_old, &
99	id_dim_y_xz_old, id_dim_zu_sp_old, &
100	id_dim_zu_xy_old, id_dim_zu_3d_old
101
102	LOGICAL :: found
103
104	LOGICAL, INTENT (INOUT) :: extend
105
106	LOGICAL, SAVE :: init_netcdf = .FALSE.
107
108	REAL, DIMENSION(1) :: last_time_coordinate
109
110	REAL, DIMENSION(:), ALLOCATABLE :: netcdf_data
111
112
113	!
114	!-- Initializing actions (return to calling routine check_parameters afterwards)
115	IF ( .NOT. init_netcdf ) THEN
116	!
117	!-- Check and set accuracy for NetCDF output. First set default value
118	nc_precision = NF90_REAL4
119
120	i = 1
121	DO WHILE ( netcdf_precision(i) /= ' ' )
122	j = INDEX( netcdf_precision(i), '_' )
123	IF ( j == 0 ) THEN
124	WRITE ( message_string, * ) 'netcdf_precision must contain a ', &
125	'"_"netcdf_precision(', i, ')="', &
126	TRIM( netcdf_precision(i) ),'"'
127	CALL message( 'define_netcdf_header', 'PA0241', 1, 2, 0, 6, 0 )
128	ENDIF
129
130	var = netcdf_precision(i)(1:j-1)
131	precision = netcdf_precision(i)(j+1:)
132
133	IF ( precision == 'NF90_REAL4' ) THEN
134	j = NF90_REAL4
135	ELSEIF ( precision == 'NF90_REAL8' ) THEN
136	j = NF90_REAL8
137	ELSE
138	WRITE ( message_string, * ) 'illegal netcdf precision: ', &
139	'netcdf_precision(', i, ')="', &
140	TRIM( netcdf_precision(i) ),'"'
141	CALL message( 'define_netcdf_header', 'PA0242', 1, 2, 0, 6, 0 )
142	ENDIF
143
144	SELECT CASE ( var )
145	CASE ( 'xy' )
146	nc_precision(1) = j
147	CASE ( 'xz' )
148	nc_precision(2) = j
149	CASE ( 'yz' )
150	nc_precision(3) = j
151	CASE ( '2d' )
152	nc_precision(1:3) = j
153	CASE ( '3d' )
154	nc_precision(4) = j
155	CASE ( 'pr' )
156	nc_precision(5) = j
157	CASE ( 'ts' )
158	nc_precision(6) = j
159	CASE ( 'sp' )
160	nc_precision(7) = j
161	CASE ( 'prt' )
162	nc_precision(8) = j
163	CASE ( 'all' )
164	nc_precision = j
165
166	CASE DEFAULT
167	WRITE ( message_string, * ) 'unknown variable in inipar ', &
168	'assignment: netcdf_precision(', i, ')="', &
169	TRIM( netcdf_precision(i) ),'"'
170	CALL message( 'define_netcdf_header', 'PA0243', 1, 2, 0, 6, 0 )
171
172	END SELECT
173
174	i = i + 1
175	IF ( i > 10 ) EXIT
176	ENDDO
177
178	init_netcdf = .TRUE.
179
180	RETURN
181
182	ENDIF
183
184	!
185	!-- Determine the mode to be processed
186	IF ( extend ) THEN
187	mode = callmode // '_ext'
188	ELSE
189	mode = callmode // '_new'
190	ENDIF
191
192	!
193	!-- Select the mode to be processed. Possibilities are 3d, xy, xz, yz,
194	!-- pr and ts.
195	SELECT CASE ( mode )
196
197	CASE ( '3d_new' )
198
199	!
200	!-- Define some global attributes of the dataset
201	nc_stat = NF90_PUT_ATT( id_set_3d(av), NF90_GLOBAL, 'Conventions', &
202	'COARDS' )
203	CALL handle_netcdf_error( 'netcdf', 62 )
204
205	IF ( av == 0 ) THEN
206	time_average_text = ' '
207	ELSE
208	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
209	averaging_interval
210	ENDIF
211	nc_stat = NF90_PUT_ATT( id_set_3d(av), NF90_GLOBAL, 'title', &
212	TRIM( run_description_header ) // &
213	TRIM( time_average_text ) )
214	CALL handle_netcdf_error( 'netcdf', 63 )
215	IF ( av == 1 ) THEN
216	WRITE ( time_average_text,'(F7.1,'' s avg'')' ) averaging_interval
217	nc_stat = NF90_PUT_ATT( id_set_3d(av), NF90_GLOBAL, 'time_avg', &
218	TRIM( time_average_text ) )
219	CALL handle_netcdf_error( 'netcdf', 63 )
220	ENDIF
221
222	!
223	!-- Define time coordinate for volume data (unlimited dimension)
224	nc_stat = NF90_DEF_DIM( id_set_3d(av), 'time', NF90_UNLIMITED, &
225	id_dim_time_3d(av) )
226	CALL handle_netcdf_error( 'netcdf', 64 )
227
228	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'time', NF90_DOUBLE, &
229	id_dim_time_3d(av), id_var_time_3d(av) )
230	CALL handle_netcdf_error( 'netcdf', 65 )
231
232	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_time_3d(av), 'units', &
233	'seconds')
234	CALL handle_netcdf_error( 'netcdf', 66 )
235
236	!
237	!-- Define spatial dimensions and coordinates:
238	!-- Define vertical coordinate grid (zu grid)
239	nc_stat = NF90_DEF_DIM( id_set_3d(av), 'zu_3d', nz_do3d-nzb+1, &
240	id_dim_zu_3d(av) )
241	CALL handle_netcdf_error( 'netcdf', 67 )
242
243	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'zu_3d', NF90_DOUBLE, &
244	id_dim_zu_3d(av), id_var_zu_3d(av) )
245	CALL handle_netcdf_error( 'netcdf', 68 )
246
247	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_zu_3d(av), 'units', &
248	'meters' )
249	CALL handle_netcdf_error( 'netcdf', 69 )
250
251	!
252	!-- Define vertical coordinate grid (zw grid)
253	nc_stat = NF90_DEF_DIM( id_set_3d(av), 'zw_3d', nz_do3d-nzb+1, &
254	id_dim_zw_3d(av) )
255	CALL handle_netcdf_error( 'netcdf', 70 )
256
257	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'zw_3d', NF90_DOUBLE, &
258	id_dim_zw_3d(av), id_var_zw_3d(av) )
259	CALL handle_netcdf_error( 'netcdf', 71 )
260
261	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_zw_3d(av), 'units', &
262	'meters' )
263	CALL handle_netcdf_error( 'netcdf', 72 )
264
265	!
266	!-- Define x-axis (for scalar position)
267	nc_stat = NF90_DEF_DIM( id_set_3d(av), 'x', nx+2, id_dim_x_3d(av) )
268	CALL handle_netcdf_error( 'netcdf', 73 )
269
270	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'x', NF90_DOUBLE, &
271	id_dim_x_3d(av), id_var_x_3d(av) )
272	CALL handle_netcdf_error( 'netcdf', 74 )
273
274	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_x_3d(av), 'units', &
275	'meters' )
276	CALL handle_netcdf_error( 'netcdf', 75 )
277
278	!
279	!-- Define x-axis (for u position)
280	nc_stat = NF90_DEF_DIM( id_set_3d(av), 'xu', nx+2, id_dim_xu_3d(av) )
281	CALL handle_netcdf_error( 'netcdf', 358 )
282
283	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'xu', NF90_DOUBLE, &
284	id_dim_xu_3d(av), id_var_xu_3d(av) )
285	CALL handle_netcdf_error( 'netcdf', 359 )
286
287	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_xu_3d(av), 'units', &
288	'meters' )
289	CALL handle_netcdf_error( 'netcdf', 360 )
290
291	!
292	!-- Define y-axis (for scalar position)
293	nc_stat = NF90_DEF_DIM( id_set_3d(av), 'y', ny+2, id_dim_y_3d(av) )
294	CALL handle_netcdf_error( 'netcdf', 76 )
295
296	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'y', NF90_DOUBLE, &
297	id_dim_y_3d(av), id_var_y_3d(av) )
298	CALL handle_netcdf_error( 'netcdf', 77 )
299
300	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_y_3d(av), 'units', &
301	'meters' )
302	CALL handle_netcdf_error( 'netcdf', 78 )
303
304	!
305	!-- Define y-axis (for v position)
306	nc_stat = NF90_DEF_DIM( id_set_3d(av), 'yv', ny+2, id_dim_yv_3d(av) )
307	CALL handle_netcdf_error( 'netcdf', 361 )
308
309	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'yv', NF90_DOUBLE, &
310	id_dim_yv_3d(av), id_var_yv_3d(av) )
311	CALL handle_netcdf_error( 'netcdf', 362 )
312
313	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_yv_3d(av), 'units', &
314	'meters' )
315	CALL handle_netcdf_error( 'netcdf', 363 )
316
317	!
318	!-- In case of non-flat topography define 2d-arrays containing the height
319	!-- informations
320	IF ( TRIM( topography ) /= 'flat' ) THEN
321	!
322	!-- Define zusi = zu(nzb_s_inner)
323	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'zusi', NF90_DOUBLE, &
324	(/ id_dim_x_3d(av), id_dim_y_3d(av) /), &
325	id_var_zusi_3d(av) )
326	CALL handle_netcdf_error( 'netcdf', 413 )
327
328	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_zusi_3d(av), &
329	'units', 'meters' )
330	CALL handle_netcdf_error( 'netcdf', 414 )
331
332	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_zusi_3d(av), &
333	'long_name', 'zu(nzb_s_inner)' )
334	CALL handle_netcdf_error( 'netcdf', 415 )
335
336	!
337	!-- Define zwwi = zw(nzb_w_inner)
338	nc_stat = NF90_DEF_VAR( id_set_3d(av), 'zwwi', NF90_DOUBLE, &
339	(/ id_dim_x_3d(av), id_dim_y_3d(av) /), &
340	id_var_zwwi_3d(av) )
341	CALL handle_netcdf_error( 'netcdf', 416 )
342
343	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_zwwi_3d(av), &
344	'units', 'meters' )
345	CALL handle_netcdf_error( 'netcdf', 417 )
346
347	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_zwwi_3d(av), &
348	'long_name', 'zw(nzb_w_inner)' )
349	CALL handle_netcdf_error( 'netcdf', 418 )
350
351	ENDIF
352
353
354	!
355	!-- Define the variables
356	var_list = ';'
357	i = 1
358
359	DO WHILE ( do3d(av,i)(1:1) /= ' ' )
360
361	!
362	!-- Check for the grid
363	found = .TRUE.
364	SELECT CASE ( do3d(av,i) )
365	!
366	!-- Most variables are defined on the scalar grid
367	CASE ( 'e', 'p', 'pc', 'pr', 'pt', 'q', 'ql', 'ql_c', 'ql_v', &
368	'ql_vp', 'qv', 'rho', 's', 'sa', 'vpt' )
369
370	grid_x = 'x'
371	grid_y = 'y'
372	grid_z = 'zu'
373	!
374	!-- u grid
375	CASE ( 'u' )
376
377	grid_x = 'xu'
378	grid_y = 'y'
379	grid_z = 'zu'
380	!
381	!-- v grid
382	CASE ( 'v' )
383
384	grid_x = 'x'
385	grid_y = 'yv'
386	grid_z = 'zu'
387	!
388	!-- w grid
389	CASE ( 'w' )
390
391	grid_x = 'x'
392	grid_y = 'y'
393	grid_z = 'zw'
394
395	CASE DEFAULT
396	!
397	!-- Check for user-defined quantities
398	CALL user_define_netcdf_grid( do3d(av,i), found, grid_x, &
399	grid_y, grid_z )
400
401	END SELECT
402
403	!
404	!-- Select the respective dimension ids
405	IF ( grid_x == 'x' ) THEN
406	id_x = id_dim_x_3d(av)
407	ELSEIF ( grid_x == 'xu' ) THEN
408	id_x = id_dim_xu_3d(av)
409	ENDIF
410
411	IF ( grid_y == 'y' ) THEN
412	id_y = id_dim_y_3d(av)
413	ELSEIF ( grid_y == 'yv' ) THEN
414	id_y = id_dim_yv_3d(av)
415	ENDIF
416
417	IF ( grid_z == 'zu' ) THEN
418	id_z = id_dim_zu_3d(av)
419	ELSEIF ( grid_z == 'zw' ) THEN
420	id_z = id_dim_zw_3d(av)
421	ENDIF
422
423	!
424	!-- Define the grid
425	nc_stat = NF90_DEF_VAR( id_set_3d(av), do3d(av,i), &
426	nc_precision(4), &
427	(/ id_x, id_y, id_z, id_dim_time_3d(av) /), &
428	id_var_do3d(av,i) )
429
430	IF ( .NOT. found ) THEN
431	WRITE ( message_string, * ) 'no grid defined for', &
432	' variable ', TRIM( do3d(av,i) )
433	CALL message( 'define_netcdf_header', 'PA0244', 0, 1, 0, 6, 0 )
434	ENDIF
435
436	var_list = TRIM( var_list ) // TRIM( do3d(av,i) ) // ';'
437
438	CALL handle_netcdf_error( 'netcdf', 79 )
439	!
440	!-- Store the 'real' name of the variable (with *, for example)
441	!-- in the long_name attribute. This is evaluated by Ferret,
442	!-- for example.
443	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_do3d(av,i), &
444	'long_name', do3d(av,i) )
445	CALL handle_netcdf_error( 'netcdf', 80 )
446	!
447	!-- Define the variable's unit
448	nc_stat = NF90_PUT_ATT( id_set_3d(av), id_var_do3d(av,i), &
449	'units', TRIM( do3d_unit(av,i) ) )
450	CALL handle_netcdf_error( 'netcdf', 357 )
451
452	i = i + 1
453
454	ENDDO
455
456	!
457	!-- No arrays to output
458	IF ( i == 1 ) RETURN
459
460	!
461	!-- Write the list of variables as global attribute (this is used by
462	!-- restart runs and by combine_plot_fields)
463	nc_stat = NF90_PUT_ATT( id_set_3d(av), NF90_GLOBAL, 'VAR_LIST', &
464	var_list )
465	CALL handle_netcdf_error( 'netcdf', 81 )
466
467	!
468	!-- Leave NetCDF define mode
469	nc_stat = NF90_ENDDEF( id_set_3d(av) )
470	CALL handle_netcdf_error( 'netcdf', 82 )
471
472	!
473	!-- Write data for x (shifted by +dx/2) and xu axis
474	ALLOCATE( netcdf_data(0:nx+1) )
475
476	DO i = 0, nx+1
477	netcdf_data(i) = ( i + 0.5 ) * dx
478	ENDDO
479
480	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_x_3d(av), netcdf_data, &
481	start = (/ 1 /), count = (/ nx+2 /) )
482	CALL handle_netcdf_error( 'netcdf', 83 )
483
484	DO i = 0, nx+1
485	netcdf_data(i) = i * dx
486	ENDDO
487
488	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_xu_3d(av), &
489	netcdf_data, start = (/ 1 /), &
490	count = (/ nx+2 /) )
491	CALL handle_netcdf_error( 'netcdf', 385 )
492
493	DEALLOCATE( netcdf_data )
494
495	!
496	!-- Write data for y (shifted by +dy/2) and yv axis
497	ALLOCATE( netcdf_data(0:ny+1) )
498
499	DO i = 0, ny+1
500	netcdf_data(i) = ( i + 0.5 ) * dy
501	ENDDO
502
503	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_y_3d(av), netcdf_data, &
504	start = (/ 1 /), count = (/ ny+2 /))
505	CALL handle_netcdf_error( 'netcdf', 84 )
506
507	DO i = 0, ny+1
508	netcdf_data(i) = i * dy
509	ENDDO
510
511	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_yv_3d(av), &
512	netcdf_data, start = (/ 1 /), &
513	count = (/ ny+2 /))
514	CALL handle_netcdf_error( 'netcdf', 387 )
515
516	DEALLOCATE( netcdf_data )
517
518	!
519	!-- Write zu and zw data (vertical axes)
520	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_zu_3d(av), &
521	zu(nzb:nz_do3d), start = (/ 1 /), &
522	count = (/ nz_do3d-nzb+1 /) )
523	CALL handle_netcdf_error( 'netcdf', 85 )
524
525
526	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_zw_3d(av), &
527	zw(nzb:nz_do3d), start = (/ 1 /), &
528	count = (/ nz_do3d-nzb+1 /) )
529	CALL handle_netcdf_error( 'netcdf', 86 )
530
531
532	!
533	!-- In case of non-flat topography write height information
534	IF ( TRIM( topography ) /= 'flat' ) THEN
535
536	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_zusi_3d(av), &
537	zu_s_inner(0:nx+1,0:ny+1), &
538	start = (/ 1, 1 /), &
539	count = (/ nx+2, ny+2 /) )
540	CALL handle_netcdf_error( 'netcdf', 419 )
541
542	nc_stat = NF90_PUT_VAR( id_set_3d(av), id_var_zwwi_3d(av), &
543	zw_w_inner(0:nx+1,0:ny+1), &
544	start = (/ 1, 1 /), &
545	count = (/ nx+2, ny+2 /) )
546	CALL handle_netcdf_error( 'netcdf', 420 )
547
548	ENDIF
549
550	CASE ( '3d_ext' )
551
552	!
553	!-- Get the list of variables and compare with the actual run.
554	!-- First var_list_old has to be reset, since GET_ATT does not assign
555	!-- trailing blanks.
556	var_list_old = ' '
557	nc_stat = NF90_GET_ATT( id_set_3d(av), NF90_GLOBAL, 'VAR_LIST', &
558	var_list_old )
559	CALL handle_netcdf_error( 'netcdf', 87 )
560
561	var_list = ';'
562	i = 1
563	DO WHILE ( do3d(av,i)(1:1) /= ' ' )
564	var_list = TRIM(var_list) // TRIM( do3d(av,i) ) // ';'
565	i = i + 1
566	ENDDO
567
568	IF ( av == 0 ) THEN
569	var = '(3d)'
570	ELSE
571	var = '(3d_av)'
572	ENDIF
573
574	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
575	message_string = 'NetCDF file for volume data ' // &
576	TRIM( var ) // ' from previous run found,' // &
577	'&but this file cannot be extended due to' // &
578	' variable mismatch.' // &
579	'&New file is created instead.'
580	CALL message( 'define_netcdf_header', 'PA0245', 0, 1, 0, 6, 0 )
581	extend = .FALSE.
582	RETURN
583	ENDIF
584
585	!
586	!-- Get and compare the number of vertical gridpoints
587	nc_stat = NF90_INQ_VARID( id_set_3d(av), 'zu_3d', id_var_zu_3d(av) )
588	CALL handle_netcdf_error( 'netcdf', 88 )
589
590	nc_stat = NF90_INQUIRE_VARIABLE( id_set_3d(av), id_var_zu_3d(av), &
591	dimids = id_dim_zu_3d_old )
592	CALL handle_netcdf_error( 'netcdf', 89 )
593	id_dim_zu_3d(av) = id_dim_zu_3d_old(1)
594
595	nc_stat = NF90_INQUIRE_DIMENSION( id_set_3d(av), id_dim_zu_3d(av), &
596	len = nz_old )
597	CALL handle_netcdf_error( 'netcdf', 90 )
598
599	IF ( nz_do3d-nzb+1 /= nz_old ) THEN
600	message_string = 'NetCDF file for volume data ' // &
601	TRIM( var ) // ' from previous run found,' // &
602	'&but this file cannot be extended due to' // &
603	' mismatch in number of' // &
604	'&vertical grid points (nz_do3d).' // &
605	'&New file is created instead.'
606	CALL message( 'define_netcdf_header', 'PA0246', 0, 1, 0, 6, 0 )
607	extend = .FALSE.
608	RETURN
609	ENDIF
610
611	!
612	!-- Get the id of the time coordinate (unlimited coordinate) and its
613	!-- last index on the file. The next time level is pl3d..count+1.
614	!-- The current time must be larger than the last output time
615	!-- on the file.
616	nc_stat = NF90_INQ_VARID( id_set_3d(av), 'time', id_var_time_3d(av) )
617	CALL handle_netcdf_error( 'netcdf', 91 )
618
619	nc_stat = NF90_INQUIRE_VARIABLE( id_set_3d(av), id_var_time_3d(av), &
620	dimids = id_dim_time_old )
621	CALL handle_netcdf_error( 'netcdf', 92 )
622
623	id_dim_time_3d(av) = id_dim_time_old(1)
624
625	nc_stat = NF90_INQUIRE_DIMENSION( id_set_3d(av), id_dim_time_3d(av), &
626	len = do3d_time_count(av) )
627	CALL handle_netcdf_error( 'netcdf', 93 )
628
629	nc_stat = NF90_GET_VAR( id_set_3d(av), id_var_time_3d(av), &
630	last_time_coordinate, &
631	start = (/ do3d_time_count(av) /), &
632	count = (/ 1 /) )
633	CALL handle_netcdf_error( 'netcdf', 94 )
634
635	IF ( last_time_coordinate(1) >= simulated_time ) THEN
636	message_string = 'NetCDF file for volume data ' // &
637	TRIM( var ) // ' from previous run found,' // &
638	'&but this file cannot be extended becaus' // &
639	'e the current output time' // &
640	'&is less or equal than the last output t' // &
641	'ime on this file.' // &
642	'&New file is created instead.'
643	CALL message( 'define_netcdf_header', 'PA0247', 0, 1, 0, 6, 0 )
644	do3d_time_count(av) = 0
645	extend = .FALSE.
646	RETURN
647	ENDIF
648
649	!
650	!-- Dataset seems to be extendable.
651	!-- Now get the variable ids.
652	i = 1
653	DO WHILE ( do3d(av,i)(1:1) /= ' ' )
654	nc_stat = NF90_INQ_VARID( id_set_3d(av), TRIM( do3d(av,i) ), &
655	id_var_do3d(av,i) )
656	CALL handle_netcdf_error( 'netcdf', 95 )
657	i = i + 1
658	ENDDO
659
660	!
661	!-- Update the title attribute on file
662	!-- In order to avoid 'data mode' errors if updated attributes are larger
663	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
664	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
665	!-- performance loss due to data copying; an alternative strategy would be
666	!-- to ensure equal attribute size. Maybe revise later.
667	IF ( av == 0 ) THEN
668	time_average_text = ' '
669	ELSE
670	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
671	averaging_interval
672	ENDIF
673	nc_stat = NF90_REDEF( id_set_3d(av) )
674	CALL handle_netcdf_error( 'netcdf', 429 )
675	nc_stat = NF90_PUT_ATT( id_set_3d(av), NF90_GLOBAL, 'title', &
676	TRIM( run_description_header ) // &
677	TRIM( time_average_text ) )
678	CALL handle_netcdf_error( 'netcdf', 96 )
679	nc_stat = NF90_ENDDEF( id_set_3d(av) )
680	CALL handle_netcdf_error( 'netcdf', 430 )
681	message_string = 'NetCDF file for volume data ' // &
682	TRIM( var ) // ' from previous run found.' // &
683	'&This file will be extended.'
684	CALL message( 'define_netcdf_header', 'PA0248', 0, 0, 0, 6, 0 )
685
686	CASE ( 'xy_new' )
687
688	!
689	!-- Define some global attributes of the dataset
690	nc_stat = NF90_PUT_ATT( id_set_xy(av), NF90_GLOBAL, 'Conventions', &
691	'COARDS' )
692	CALL handle_netcdf_error( 'netcdf', 97 )
693
694	IF ( av == 0 ) THEN
695	time_average_text = ' '
696	ELSE
697	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
698	averaging_interval
699	ENDIF
700	nc_stat = NF90_PUT_ATT( id_set_xy(av), NF90_GLOBAL, 'title', &
701	TRIM( run_description_header ) // &
702	TRIM( time_average_text ) )
703	CALL handle_netcdf_error( 'netcdf', 98 )
704	IF ( av == 1 ) THEN
705	WRITE ( time_average_text,'(F7.1,'' s avg'')' ) averaging_interval
706	nc_stat = NF90_PUT_ATT( id_set_xy(av), NF90_GLOBAL, 'time_avg', &
707	TRIM( time_average_text ) )
708	CALL handle_netcdf_error( 'netcdf', 98 )
709	ENDIF
710
711	!
712	!-- Define time coordinate for xy sections (unlimited dimension)
713	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'time', NF90_UNLIMITED, &
714	id_dim_time_xy(av) )
715	CALL handle_netcdf_error( 'netcdf', 99 )
716
717	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'time', NF90_DOUBLE, &
718	id_dim_time_xy(av), id_var_time_xy(av) )
719	CALL handle_netcdf_error( 'netcdf', 100 )
720
721	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_time_xy(av), 'units', &
722	'seconds')
723	CALL handle_netcdf_error( 'netcdf', 101 )
724
725	!
726	!-- Define the spatial dimensions and coordinates for xy-sections.
727	!-- First, determine the number of horizontal sections to be written.
728	IF ( section(1,1) == -9999 ) THEN
729	RETURN
730	ELSE
731	ns = 1
732	DO WHILE ( section(ns,1) /= -9999 .AND. ns <= 100 )
733	ns = ns + 1
734	ENDDO
735	ns = ns - 1
736	ENDIF
737
738	!
739	!-- Define vertical coordinate grid (zu grid)
740	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'zu_xy', ns, id_dim_zu_xy(av) )
741	CALL handle_netcdf_error( 'netcdf', 102 )
742
743	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'zu_xy', NF90_DOUBLE, &
744	id_dim_zu_xy(av), id_var_zu_xy(av) )
745	CALL handle_netcdf_error( 'netcdf', 103 )
746
747	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_zu_xy(av), 'units', &
748	'meters' )
749	CALL handle_netcdf_error( 'netcdf', 104 )
750
751	!
752	!-- Define vertical coordinate grid (zw grid)
753	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'zw_xy', ns, id_dim_zw_xy(av) )
754	CALL handle_netcdf_error( 'netcdf', 105 )
755
756	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'zw_xy', NF90_DOUBLE, &
757	id_dim_zw_xy(av), id_var_zw_xy(av) )
758	CALL handle_netcdf_error( 'netcdf', 106 )
759
760	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_zw_xy(av), 'units', &
761	'meters' )
762	CALL handle_netcdf_error( 'netcdf', 107 )
763
764	!
765	!-- Define a pseudo vertical coordinate grid for the surface variables
766	!-- u* and t* to store their height level
767	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'zu1_xy', 1, &
768	id_dim_zu1_xy(av) )
769	CALL handle_netcdf_error( 'netcdf', 108 )
770
771	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'zu1_xy', NF90_DOUBLE, &
772	id_dim_zu1_xy(av), id_var_zu1_xy(av) )
773	CALL handle_netcdf_error( 'netcdf', 109 )
774
775	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_zu1_xy(av), 'units', &
776	'meters' )
777	CALL handle_netcdf_error( 'netcdf', 110 )
778
779	!
780	!-- Define a variable to store the layer indices of the horizontal cross
781	!-- sections, too
782	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'ind_z_xy', NF90_DOUBLE, &
783	id_dim_zu_xy(av), id_var_ind_z_xy(av) )
784	CALL handle_netcdf_error( 'netcdf', 111 )
785
786	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_ind_z_xy(av), 'units', &
787	'gridpoints')
788	CALL handle_netcdf_error( 'netcdf', 112 )
789
790	!
791	!-- Define x-axis (for scalar position)
792	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'x', nx+2, id_dim_x_xy(av) )
793	CALL handle_netcdf_error( 'netcdf', 113 )
794
795	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'x', NF90_DOUBLE, &
796	id_dim_x_xy(av), id_var_x_xy(av) )
797	CALL handle_netcdf_error( 'netcdf', 114 )
798
799
800	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_x_xy(av), 'units', &
801	'meters' )
802	CALL handle_netcdf_error( 'netcdf', 115 )
803
804	!
805	!-- Define x-axis (for u position)
806	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'xu', nx+2, id_dim_xu_xy(av) )
807	CALL handle_netcdf_error( 'netcdf', 388 )
808
809	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'xu', NF90_DOUBLE, &
810	id_dim_xu_xy(av), id_var_xu_xy(av) )
811	CALL handle_netcdf_error( 'netcdf', 389 )
812
813	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_xu_xy(av), 'units', &
814	'meters' )
815	CALL handle_netcdf_error( 'netcdf', 390 )
816
817	!
818	!-- Define y-axis (for scalar position)
819	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'y', ny+2, id_dim_y_xy(av) )
820	CALL handle_netcdf_error( 'netcdf', 116 )
821
822	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'y', NF90_DOUBLE, &
823	id_dim_y_xy(av), id_var_y_xy(av) )
824	CALL handle_netcdf_error( 'netcdf', 117 )
825
826	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_y_xy(av), 'units', &
827	'meters' )
828	CALL handle_netcdf_error( 'netcdf', 118 )
829
830	!
831	!-- Define y-axis (for scalar position)
832	nc_stat = NF90_DEF_DIM( id_set_xy(av), 'yv', ny+2, id_dim_yv_xy(av) )
833	CALL handle_netcdf_error( 'netcdf', 364 )
834
835	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'yv', NF90_DOUBLE, &
836	id_dim_yv_xy(av), id_var_yv_xy(av) )
837	CALL handle_netcdf_error( 'netcdf', 365 )
838
839	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_yv_xy(av), 'units', &
840	'meters' )
841	CALL handle_netcdf_error( 'netcdf', 366 )
842
843	!
844	!-- In case of non-flat topography define 2d-arrays containing the height
845	!-- informations
846	IF ( TRIM( topography ) /= 'flat' ) THEN
847	!
848	!-- Define zusi = zu(nzb_s_inner)
849	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'zusi', NF90_DOUBLE, &
850	(/ id_dim_x_xy(av), id_dim_y_xy(av) /), &
851	id_var_zusi_xy(av) )
852	CALL handle_netcdf_error( 'netcdf', 421 )
853
854	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_zusi_xy(av), &
855	'units', 'meters' )
856	CALL handle_netcdf_error( 'netcdf', 422 )
857
858	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_zusi_xy(av), &
859	'long_name', 'zu(nzb_s_inner)' )
860	CALL handle_netcdf_error( 'netcdf', 423 )
861
862	!
863	!-- Define zwwi = zw(nzb_w_inner)
864	nc_stat = NF90_DEF_VAR( id_set_xy(av), 'zwwi', NF90_DOUBLE, &
865	(/ id_dim_x_xy(av), id_dim_y_xy(av) /), &
866	id_var_zwwi_xy(av) )
867	CALL handle_netcdf_error( 'netcdf', 424 )
868
869	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_zwwi_xy(av), &
870	'units', 'meters' )
871	CALL handle_netcdf_error( 'netcdf', 425 )
872
873	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_zwwi_xy(av), &
874	'long_name', 'zw(nzb_w_inner)' )
875	CALL handle_netcdf_error( 'netcdf', 426 )
876
877	ENDIF
878
879
880	!
881	!-- Define the variables
882	var_list = ';'
883	i = 1
884
885	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
886
887	IF ( INDEX( do2d(av,i), 'xy' ) /= 0 ) THEN
888	!
889	!-- If there is a star in the variable name (u* or t*), it is a
890	!-- surface variable. Define it with id_dim_zu1_xy.
891	IF ( INDEX( do2d(av,i), '*' ) /= 0 ) THEN
892	!
893	!-- First, remove those characters not allowed by NetCDF
894	netcdf_var_name = do2d(av,i)
895	CALL clean_netcdf_varname( netcdf_var_name )
896
897	nc_stat = NF90_DEF_VAR( id_set_xy(av), netcdf_var_name, &
898	nc_precision(1), &
899	(/ id_dim_x_xy(av), id_dim_y_xy(av),&
900	id_dim_zu1_xy(av), &
901	id_dim_time_xy(av) /), &
902	id_var_do2d(av,i) )
903
904	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
905
906	ELSE
907
908	!
909	!-- Check for the grid
910	found = .TRUE.
911	SELECT CASE ( do2d(av,i) )
912	!
913	!-- Most variables are defined on the zu grid
914	CASE ( 'e_xy', 'p_xy', 'pc_xy', 'pr_xy', 'pt_xy', 'q_xy',&
915	'ql_xy', 'ql_c_xy', 'ql_v_xy', 'ql_vp_xy', &
916	'qv_xy', 'rho_xy', 's_xy', 'sa_xy', 'vpt_xy' )
917
918	grid_x = 'x'
919	grid_y = 'y'
920	grid_z = 'zu'
921	!
922	!-- u grid
923	CASE ( 'u_xy' )
924
925	grid_x = 'xu'
926	grid_y = 'y'
927	grid_z = 'zu'
928	!
929	!-- v grid
930	CASE ( 'v_xy' )
931
932	grid_x = 'x'
933	grid_y = 'yv'
934	grid_z = 'zu'
935	!
936	!-- w grid
937	CASE ( 'w_xy' )
938
939	grid_x = 'x'
940	grid_y = 'y'
941	grid_z = 'zw'
942
943	CASE DEFAULT
944	!
945	!-- Check for user-defined quantities
946	CALL user_define_netcdf_grid( do2d(av,i), found, &
947	grid_x, grid_y, grid_z )
948
949	END SELECT
950
951	!
952	!-- Select the respective dimension ids
953	IF ( grid_x == 'x' ) THEN
954	id_x = id_dim_x_xy(av)
955	ELSEIF ( grid_x == 'xu' ) THEN
956	id_x = id_dim_xu_xy(av)
957	ENDIF
958
959	IF ( grid_y == 'y' ) THEN
960	id_y = id_dim_y_xy(av)
961	ELSEIF ( grid_y == 'yv' ) THEN
962	id_y = id_dim_yv_xy(av)
963	ENDIF
964
965	IF ( grid_z == 'zu' ) THEN
966	id_z = id_dim_zu_xy(av)
967	ELSEIF ( grid_z == 'zw' ) THEN
968	id_z = id_dim_zw_xy(av)
969	ENDIF
970
971	!
972	!-- Define the grid
973	nc_stat = NF90_DEF_VAR( id_set_xy(av), do2d(av,i), &
974	nc_precision(1), &
975	(/ id_x, id_y, id_z, id_dim_time_xy(av) /), &
976	id_var_do2d(av,i) )
977
978	IF ( .NOT. found ) THEN
979	WRITE ( message_string, * ) 'no grid defined for', &
980	' variable ', TRIM( do2d(av,i) )
981	CALL message( 'define_netcdf_header', 'PA0244',&
982	0, 1, 0, 6, 0 )
983	ENDIF
984
985	var_list = TRIM( var_list ) // TRIM( do2d(av,i) ) // ';'
986
987	ENDIF
988
989	CALL handle_netcdf_error( 'netcdf', 119 )
990	!
991	!-- Store the 'real' name of the variable (with *, for example)
992	!-- in the long_name attribute. This is evaluated by Ferret,
993	!-- for example.
994	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_do2d(av,i), &
995	'long_name', do2d(av,i) )
996	CALL handle_netcdf_error( 'netcdf', 120 )
997	!
998	!-- Define the variable's unit
999	nc_stat = NF90_PUT_ATT( id_set_xy(av), id_var_do2d(av,i), &
1000	'units', TRIM( do2d_unit(av,i) ) )
1001	CALL handle_netcdf_error( 'netcdf', 354 )
1002	ENDIF
1003
1004	i = i + 1
1005
1006	ENDDO
1007
1008	!
1009	!-- No arrays to output. Close the netcdf file and return.
1010	IF ( i == 1 ) RETURN
1011
1012	!
1013	!-- Write the list of variables as global attribute (this is used by
1014	!-- restart runs and by combine_plot_fields)
1015	nc_stat = NF90_PUT_ATT( id_set_xy(av), NF90_GLOBAL, 'VAR_LIST', &
1016	var_list )
1017	CALL handle_netcdf_error( 'netcdf', 121 )
1018
1019	!
1020	!-- Leave NetCDF define mode
1021	nc_stat = NF90_ENDDEF( id_set_xy(av) )
1022	CALL handle_netcdf_error( 'netcdf', 122 )
1023
1024	!
1025	!-- Write axis data: z_xy, x, y
1026	ALLOCATE( netcdf_data(1:ns) )
1027
1028	!
1029	!-- Write zu data
1030	DO i = 1, ns
1031	IF( section(i,1) == -1 ) THEN
1032	netcdf_data(i) = -1.0 ! section averaged along z
1033	ELSE
1034	netcdf_data(i) = zu( section(i,1) )
1035	ENDIF
1036	ENDDO
1037	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_zu_xy(av), &
1038	netcdf_data, start = (/ 1 /), &
1039	count = (/ ns /) )
1040	CALL handle_netcdf_error( 'netcdf', 123 )
1041
1042	!
1043	!-- Write zw data
1044	DO i = 1, ns
1045	IF( section(i,1) == -1 ) THEN
1046	netcdf_data(i) = -1.0 ! section averaged along z
1047	ELSE
1048	netcdf_data(i) = zw( section(i,1) )
1049	ENDIF
1050	ENDDO
1051	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_zw_xy(av), &
1052	netcdf_data, start = (/ 1 /), &
1053	count = (/ ns /) )
1054	CALL handle_netcdf_error( 'netcdf', 124 )
1055
1056	!
1057	!-- Write gridpoint number data
1058	netcdf_data(1:ns) = section(1:ns,1)
1059	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_ind_z_xy(av), &
1060	netcdf_data, start = (/ 1 /), &
1061	count = (/ ns /) )
1062	CALL handle_netcdf_error( 'netcdf', 125 )
1063
1064	DEALLOCATE( netcdf_data )
1065
1066	!
1067	!-- Write the cross section height u, t
1068	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_zu1_xy(av), &
1069	(/ zu(nzb+1) /), start = (/ 1 /), &
1070	count = (/ 1 /) )
1071	CALL handle_netcdf_error( 'netcdf', 126 )
1072
1073	!
1074	!-- Write data for x (shifted by +dx/2) and xu axis
1075	ALLOCATE( netcdf_data(0:nx+1) )
1076
1077	DO i = 0, nx+1
1078	netcdf_data(i) = ( i + 0.5 ) * dx
1079	ENDDO
1080
1081	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_x_xy(av), netcdf_data, &
1082	start = (/ 1 /), count = (/ nx+2 /) )
1083	CALL handle_netcdf_error( 'netcdf', 127 )
1084
1085	DO i = 0, nx+1
1086	netcdf_data(i) = i * dx
1087	ENDDO
1088
1089	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_xu_xy(av), &
1090	netcdf_data, start = (/ 1 /), &
1091	count = (/ nx+2 /) )
1092	CALL handle_netcdf_error( 'netcdf', 367 )
1093
1094	DEALLOCATE( netcdf_data )
1095
1096	!
1097	!-- Write data for y (shifted by +dy/2) and yv axis
1098	ALLOCATE( netcdf_data(0:ny+1) )
1099
1100	DO i = 0, ny+1
1101	netcdf_data(i) = ( i + 0.5 ) * dy
1102	ENDDO
1103
1104	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_y_xy(av), netcdf_data, &
1105	start = (/ 1 /), count = (/ ny+2 /))
1106	CALL handle_netcdf_error( 'netcdf', 128 )
1107
1108	DO i = 0, ny+1
1109	netcdf_data(i) = i * dy
1110	ENDDO
1111
1112	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_yv_xy(av), &
1113	netcdf_data, start = (/ 1 /), &
1114	count = (/ ny+2 /))
1115	CALL handle_netcdf_error( 'netcdf', 368 )
1116
1117	DEALLOCATE( netcdf_data )
1118
1119	!
1120	!-- In case of non-flat topography write height information
1121	IF ( TRIM( topography ) /= 'flat' ) THEN
1122
1123	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_zusi_xy(av), &
1124	zu_s_inner(0:nx+1,0:ny+1), &
1125	start = (/ 1, 1 /), &
1126	count = (/ nx+2, ny+2 /) )
1127	CALL handle_netcdf_error( 'netcdf', 427 )
1128
1129	nc_stat = NF90_PUT_VAR( id_set_xy(av), id_var_zwwi_xy(av), &
1130	zw_w_inner(0:nx+1,0:ny+1), &
1131	start = (/ 1, 1 /), &
1132	count = (/ nx+2, ny+2 /) )
1133	CALL handle_netcdf_error( 'netcdf', 428 )
1134
1135	ENDIF
1136
1137
1138	CASE ( 'xy_ext' )
1139
1140	!
1141	!-- Get the list of variables and compare with the actual run.
1142	!-- First var_list_old has to be reset, since GET_ATT does not assign
1143	!-- trailing blanks.
1144	var_list_old = ' '
1145	nc_stat = NF90_GET_ATT( id_set_xy(av), NF90_GLOBAL, 'VAR_LIST', &
1146	var_list_old )
1147	CALL handle_netcdf_error( 'netcdf', 129 )
1148
1149	var_list = ';'
1150	i = 1
1151	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
1152	IF ( INDEX( do2d(av,i), 'xy' ) /= 0 ) THEN
1153	netcdf_var_name = do2d(av,i)
1154	CALL clean_netcdf_varname( netcdf_var_name )
1155	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
1156	ENDIF
1157	i = i + 1
1158	ENDDO
1159
1160	IF ( av == 0 ) THEN
1161	var = '(xy)'
1162	ELSE
1163	var = '(xy_av)'
1164	ENDIF
1165
1166	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
1167	message_string = 'NetCDF file for cross-sections ' // &
1168	TRIM( var ) // ' from previous run found,' // &
1169	'& but this file cannot be extended due to' // &
1170	' variable mismatch.' // &
1171	'&New file is created instead.'
1172	CALL message( 'define_netcdf_header', 'PA0249', 0, 1, 0, 6, 0 )
1173	extend = .FALSE.
1174	RETURN
1175	ENDIF
1176
1177	!
1178	!-- Calculate the number of current sections
1179	ns = 1
1180	DO WHILE ( section(ns,1) /= -9999 .AND. ns <= 100 )
1181	ns = ns + 1
1182	ENDDO
1183	ns = ns - 1
1184
1185	!
1186	!-- Get and compare the number of horizontal cross sections
1187	nc_stat = NF90_INQ_VARID( id_set_xy(av), 'zu_xy', id_var_zu_xy(av) )
1188	CALL handle_netcdf_error( 'netcdf', 130 )
1189
1190	nc_stat = NF90_INQUIRE_VARIABLE( id_set_xy(av), id_var_zu_xy(av), &
1191	dimids = id_dim_zu_xy_old )
1192	CALL handle_netcdf_error( 'netcdf', 131 )
1193	id_dim_zu_xy(av) = id_dim_zu_xy_old(1)
1194
1195	nc_stat = NF90_INQUIRE_DIMENSION( id_set_xy(av), id_dim_zu_xy(av), &
1196	len = ns_old )
1197	CALL handle_netcdf_error( 'netcdf', 132 )
1198
1199	IF ( ns /= ns_old ) THEN
1200	message_string = 'NetCDF file for cross-sections ' // &
1201	TRIM( var ) // ' from previous run found,' // &
1202	'&but this file cannot be extended due to' // &
1203	' mismatch in number of' // &
1204	'&cross sections.' // &
1205	'&New file is created instead.'
1206	CALL message( 'define_netcdf_header', 'PA0250', 0, 1, 0, 6, 0 )
1207	extend = .FALSE.
1208	RETURN
1209	ENDIF
1210
1211	!
1212	!-- Get and compare the heights of the cross sections
1213	ALLOCATE( netcdf_data(1:ns_old) )
1214
1215	nc_stat = NF90_GET_VAR( id_set_xy(av), id_var_zu_xy(av), netcdf_data )
1216	CALL handle_netcdf_error( 'netcdf', 133 )
1217
1218	DO i = 1, ns
1219	IF ( section(i,1) /= -1 ) THEN
1220	IF ( zu(section(i,1)) /= netcdf_data(i) ) THEN
1221	message_string = 'NetCDF file for cross-sections ' // &
1222	TRIM( var ) // ' from previous run found,' // &
1223	'&but this file cannot be extended' // &
1224	' due to mismatch in cross' // &
1225	'&section levels.' // &
1226	'&New file is created instead.'
1227	CALL message( 'define_netcdf_header', 'PA0251', &
1228	0, 1, 0, 6, 0 )
1229	extend = .FALSE.
1230	RETURN
1231	ENDIF
1232	ELSE
1233	IF ( -1.0 /= netcdf_data(i) ) THEN
1234	message_string = 'NetCDF file for cross-sections ' // &
1235	TRIM( var ) // ' from previous run found,' // &
1236	'&but this file cannot be extended' // &
1237	' due to mismatch in cross' // &
1238	'&section levels.' // &
1239	'&New file is created instead.'
1240	CALL message( 'define_netcdf_header', 'PA0251',&
1241	0, 1, 0, 6, 0 )
1242	extend = .FALSE.
1243	RETURN
1244	ENDIF
1245	ENDIF
1246	ENDDO
1247
1248	DEALLOCATE( netcdf_data )
1249
1250	!
1251	!-- Get the id of the time coordinate (unlimited coordinate) and its
1252	!-- last index on the file. The next time level is do2d..count+1.
1253	!-- The current time must be larger than the last output time
1254	!-- on the file.
1255	nc_stat = NF90_INQ_VARID( id_set_xy(av), 'time', id_var_time_xy(av) )
1256	CALL handle_netcdf_error( 'netcdf', 134 )
1257
1258	nc_stat = NF90_INQUIRE_VARIABLE( id_set_xy(av), id_var_time_xy(av), &
1259	dimids = id_dim_time_old )
1260	CALL handle_netcdf_error( 'netcdf', 135 )
1261	id_dim_time_xy(av) = id_dim_time_old(1)
1262
1263	nc_stat = NF90_INQUIRE_DIMENSION( id_set_xy(av), id_dim_time_xy(av), &
1264	len = do2d_xy_time_count(av) )
1265	CALL handle_netcdf_error( 'netcdf', 136 )
1266
1267	nc_stat = NF90_GET_VAR( id_set_xy(av), id_var_time_xy(av), &
1268	last_time_coordinate, &
1269	start = (/ do2d_xy_time_count(av) /), &
1270	count = (/ 1 /) )
1271	CALL handle_netcdf_error( 'netcdf', 137 )
1272
1273	IF ( last_time_coordinate(1) >= simulated_time ) THEN
1274	message_string = 'NetCDF file for cross sections ' // &
1275	TRIM( var ) // ' from previous run found,' // &
1276	'&but this file cannot be extended becaus' // &
1277	'e the current output time' // &
1278	'&is less or equal than the last output t' // &
1279	'ime on this file.' // &
1280	'&New file is created instead.'
1281	CALL message( 'define_netcdf_header', 'PA0252', 0, 1, 0, 6, 0 )
1282	do2d_xy_time_count(av) = 0
1283	extend = .FALSE.
1284	RETURN
1285	ENDIF
1286
1287	!
1288	!-- Dataset seems to be extendable.
1289	!-- Now get the variable ids.
1290	i = 1
1291	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
1292	IF ( INDEX( do2d(av,i), 'xy' ) /= 0 ) THEN
1293	netcdf_var_name = do2d(av,i)
1294	CALL clean_netcdf_varname( netcdf_var_name )
1295	nc_stat = NF90_INQ_VARID( id_set_xy(av), netcdf_var_name, &
1296	id_var_do2d(av,i) )
1297	CALL handle_netcdf_error( 'netcdf', 138 )
1298	ENDIF
1299	i = i + 1
1300	ENDDO
1301
1302	!
1303	!-- Update the title attribute on file
1304	!-- In order to avoid 'data mode' errors if updated attributes are larger
1305	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
1306	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
1307	!-- performance loss due to data copying; an alternative strategy would be
1308	!-- to ensure equal attribute size in a job chain. Maybe revise later.
1309	IF ( av == 0 ) THEN
1310	time_average_text = ' '
1311	ELSE
1312	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
1313	averaging_interval
1314	ENDIF
1315	nc_stat = NF90_REDEF( id_set_xy(av) )
1316	CALL handle_netcdf_error( 'netcdf', 431 )
1317	nc_stat = NF90_PUT_ATT( id_set_xy(av), NF90_GLOBAL, 'title', &
1318	TRIM( run_description_header ) // &
1319	TRIM( time_average_text ) )
1320	CALL handle_netcdf_error( 'netcdf', 139 )
1321	nc_stat = NF90_ENDDEF( id_set_xy(av) )
1322	CALL handle_netcdf_error( 'netcdf', 432 )
1323	message_string = 'NetCDF file for cross-sections ' // &
1324	TRIM( var ) // ' from previous run found.' // &
1325	'&This file will be extended.'
1326	CALL message( 'define_netcdf_header', 'PA0253', 0, 0, 0, 6, 0 )
1327
1328
1329	CASE ( 'xz_new' )
1330
1331	!
1332	!-- Define some global attributes of the dataset
1333	nc_stat = NF90_PUT_ATT( id_set_xz(av), NF90_GLOBAL, 'Conventions', &
1334	'COARDS' )
1335	CALL handle_netcdf_error( 'netcdf', 140 )
1336
1337	IF ( av == 0 ) THEN
1338	time_average_text = ' '
1339	ELSE
1340	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
1341	averaging_interval
1342	ENDIF
1343	nc_stat = NF90_PUT_ATT( id_set_xz(av), NF90_GLOBAL, 'title', &
1344	TRIM( run_description_header ) // &
1345	TRIM( time_average_text ) )
1346	CALL handle_netcdf_error( 'netcdf', 141 )
1347	IF ( av == 1 ) THEN
1348	WRITE ( time_average_text,'(F7.1,'' s avg'')' ) averaging_interval
1349	nc_stat = NF90_PUT_ATT( id_set_xz(av), NF90_GLOBAL, 'time_avg', &
1350	TRIM( time_average_text ) )
1351	CALL handle_netcdf_error( 'netcdf', 141 )
1352	ENDIF
1353
1354	!
1355	!-- Define time coordinate for xz sections (unlimited dimension)
1356	nc_stat = NF90_DEF_DIM( id_set_xz(av), 'time', NF90_UNLIMITED, &
1357	id_dim_time_xz(av) )
1358	CALL handle_netcdf_error( 'netcdf', 142 )
1359
1360	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'time', NF90_DOUBLE, &
1361	id_dim_time_xz(av), id_var_time_xz(av) )
1362	CALL handle_netcdf_error( 'netcdf', 143 )
1363
1364	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_time_xz(av), 'units', &
1365	'seconds')
1366	CALL handle_netcdf_error( 'netcdf', 144 )
1367
1368	!
1369	!-- Define the spatial dimensions and coordinates for xz-sections.
1370	!-- First, determine the number of vertical sections to be written.
1371	IF ( section(1,2) == -9999 ) THEN
1372	RETURN
1373	ELSE
1374	ns = 1
1375	DO WHILE ( section(ns,2) /= -9999 .AND. ns <= 100 )
1376	ns = ns + 1
1377	ENDDO
1378	ns = ns - 1
1379	ENDIF
1380
1381	!
1382	!-- Define y-axis (for scalar position)
1383	nc_stat = NF90_DEF_DIM( id_set_xz(av), 'y_xz', ns, id_dim_y_xz(av) )
1384	CALL handle_netcdf_error( 'netcdf', 145 )
1385
1386	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'y_xz', NF90_DOUBLE, &
1387	id_dim_y_xz(av), id_var_y_xz(av) )
1388	CALL handle_netcdf_error( 'netcdf', 146 )
1389
1390	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_y_xz(av), 'units', &
1391	'meters' )
1392	CALL handle_netcdf_error( 'netcdf', 147 )
1393
1394	!
1395	!-- Define y-axis (for v position)
1396	nc_stat = NF90_DEF_DIM( id_set_xz(av), 'yv_xz', ns, id_dim_yv_xz(av) )
1397	CALL handle_netcdf_error( 'netcdf', 369 )
1398
1399	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'yv_xz', NF90_DOUBLE, &
1400	id_dim_yv_xz(av), id_var_yv_xz(av) )
1401	CALL handle_netcdf_error( 'netcdf', 370 )
1402
1403	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_yv_xz(av), 'units', &
1404	'meters' )
1405	CALL handle_netcdf_error( 'netcdf', 371 )
1406
1407	!
1408	!-- Define a variable to store the layer indices of the vertical cross
1409	!-- sections
1410	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'ind_y_xz', NF90_DOUBLE, &
1411	id_dim_y_xz(av), id_var_ind_y_xz(av) )
1412	CALL handle_netcdf_error( 'netcdf', 148 )
1413
1414	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_ind_y_xz(av), 'units', &
1415	'gridpoints')
1416	CALL handle_netcdf_error( 'netcdf', 149 )
1417
1418	!
1419	!-- Define x-axis (for scalar position)
1420	nc_stat = NF90_DEF_DIM( id_set_xz(av), 'x', nx+2, id_dim_x_xz(av) )
1421	CALL handle_netcdf_error( 'netcdf', 150 )
1422
1423	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'x', NF90_DOUBLE, &
1424	id_dim_x_xz(av), id_var_x_xz(av) )
1425	CALL handle_netcdf_error( 'netcdf', 151 )
1426
1427	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_x_xz(av), 'units', &
1428	'meters' )
1429	CALL handle_netcdf_error( 'netcdf', 152 )
1430
1431	!
1432	!-- Define x-axis (for u position)
1433	nc_stat = NF90_DEF_DIM( id_set_xz(av), 'xu', nx+2, id_dim_xu_xz(av) )
1434	CALL handle_netcdf_error( 'netcdf', 372 )
1435
1436	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'xu', NF90_DOUBLE, &
1437	id_dim_xu_xz(av), id_var_xu_xz(av) )
1438	CALL handle_netcdf_error( 'netcdf', 373 )
1439
1440	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_xu_xz(av), 'units', &
1441	'meters' )
1442	CALL handle_netcdf_error( 'netcdf', 374 )
1443
1444	!
1445	!-- Define the two z-axes (zu and zw)
1446	nc_stat = NF90_DEF_DIM( id_set_xz(av), 'zu', nz+2, id_dim_zu_xz(av) )
1447	CALL handle_netcdf_error( 'netcdf', 153 )
1448
1449	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'zu', NF90_DOUBLE, &
1450	id_dim_zu_xz(av), id_var_zu_xz(av) )
1451	CALL handle_netcdf_error( 'netcdf', 154 )
1452
1453	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_zu_xz(av), 'units', &
1454	'meters' )
1455	CALL handle_netcdf_error( 'netcdf', 155 )
1456
1457	nc_stat = NF90_DEF_DIM( id_set_xz(av), 'zw', nz+2, id_dim_zw_xz(av) )
1458	CALL handle_netcdf_error( 'netcdf', 156 )
1459
1460	nc_stat = NF90_DEF_VAR( id_set_xz(av), 'zw', NF90_DOUBLE, &
1461	id_dim_zw_xz(av), id_var_zw_xz(av) )
1462	CALL handle_netcdf_error( 'netcdf', 157 )
1463
1464	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_zw_xz(av), 'units', &
1465	'meters' )
1466	CALL handle_netcdf_error( 'netcdf', 158 )
1467
1468
1469	!
1470	!-- Define the variables
1471	var_list = ';'
1472	i = 1
1473
1474	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
1475
1476	IF ( INDEX( do2d(av,i), 'xz' ) /= 0 ) THEN
1477
1478	!
1479	!-- Check for the grid
1480	found = .TRUE.
1481	SELECT CASE ( do2d(av,i) )
1482	!
1483	!-- Most variables are defined on the zu grid
1484	CASE ( 'e_xz', 'p_xz', 'pc_xz', 'pr_xz', 'pt_xz', 'q_xz', &
1485	'ql_xz', 'ql_c_xz', 'ql_v_xz', 'ql_vp_xz', 'qv_xz', &
1486	'rho_xz', 's_xz', 'sa_xz', 'vpt_xz' )
1487
1488	grid_x = 'x'
1489	grid_y = 'y'
1490	grid_z = 'zu'
1491	!
1492	!-- u grid
1493	CASE ( 'u_xz' )
1494
1495	grid_x = 'xu'
1496	grid_y = 'y'
1497	grid_z = 'zu'
1498	!
1499	!-- v grid
1500	CASE ( 'v_xz' )
1501
1502	grid_x = 'x'
1503	grid_y = 'yv'
1504	grid_z = 'zu'
1505	!
1506	!-- w grid
1507	CASE ( 'w_xz' )
1508
1509	grid_x = 'x'
1510	grid_y = 'y'
1511	grid_z = 'zw'
1512
1513	CASE DEFAULT
1514	!
1515	!-- Check for user-defined quantities
1516	CALL user_define_netcdf_grid( do2d(av,i), found, &
1517	grid_x, grid_y, grid_z )
1518
1519	END SELECT
1520
1521	!
1522	!-- Select the respective dimension ids
1523	IF ( grid_x == 'x' ) THEN
1524	id_x = id_dim_x_xz(av)
1525	ELSEIF ( grid_x == 'xu' ) THEN
1526	id_x = id_dim_xu_xz(av)
1527	ENDIF
1528
1529	IF ( grid_y == 'y' ) THEN
1530	id_y = id_dim_y_xz(av)
1531	ELSEIF ( grid_y == 'yv' ) THEN
1532	id_y = id_dim_yv_xz(av)
1533	ENDIF
1534
1535	IF ( grid_z == 'zu' ) THEN
1536	id_z = id_dim_zu_xz(av)
1537	ELSEIF ( grid_z == 'zw' ) THEN
1538	id_z = id_dim_zw_xz(av)
1539	ENDIF
1540
1541	!
1542	!-- Define the grid
1543	nc_stat = NF90_DEF_VAR( id_set_xz(av), do2d(av,i), &
1544	nc_precision(2), &
1545	(/ id_x, id_y, id_z, id_dim_time_xz(av) /), &
1546	id_var_do2d(av,i) )
1547
1548	IF ( .NOT. found ) THEN
1549	WRITE ( message_string, * ) 'no grid defined for', &
1550	' variable ', TRIM( do2d(av,i) )
1551	CALL message( 'define_netcdf_header', 'PA0244',&
1552	0, 1, 0, 6, 0 )
1553	ENDIF
1554
1555	var_list = TRIM( var_list ) // TRIM( do2d(av,i) ) // ';'
1556
1557	CALL handle_netcdf_error( 'netcdf', 159 )
1558	!
1559	!-- Store the 'real' name of the variable (with *, for example)
1560	!-- in the long_name attribute. This is evaluated by Ferret,
1561	!-- for example.
1562	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_do2d(av,i), &
1563	'long_name', do2d(av,i) )
1564	CALL handle_netcdf_error( 'netcdf', 160 )
1565	!
1566	!-- Define the variable's unit
1567	nc_stat = NF90_PUT_ATT( id_set_xz(av), id_var_do2d(av,i), &
1568	'units', TRIM( do2d_unit(av,i) ) )
1569	CALL handle_netcdf_error( 'netcdf', 355 )
1570	ENDIF
1571
1572	i = i + 1
1573
1574	ENDDO
1575
1576	!
1577	!-- No arrays to output. Close the netcdf file and return.
1578	IF ( i == 1 ) RETURN
1579
1580	!
1581	!-- Write the list of variables as global attribute (this is used by
1582	!-- restart runs and by combine_plot_fields)
1583	nc_stat = NF90_PUT_ATT( id_set_xz(av), NF90_GLOBAL, 'VAR_LIST', &
1584	var_list )
1585	CALL handle_netcdf_error( 'netcdf', 161 )
1586
1587	!
1588	!-- Leave NetCDF define mode
1589	nc_stat = NF90_ENDDEF( id_set_xz(av) )
1590	CALL handle_netcdf_error( 'netcdf', 162 )
1591
1592	!
1593	!-- Write axis data: y_xz, x, zu, zw
1594	ALLOCATE( netcdf_data(1:ns) )
1595
1596	!
1597	!-- Write y_xz data (shifted by +dy/2)
1598	DO i = 1, ns
1599	IF( section(i,2) == -1 ) THEN
1600	netcdf_data(i) = -1.0 ! section averaged along y
1601	ELSE
1602	netcdf_data(i) = ( section(i,2) + 0.5 ) * dy
1603	ENDIF
1604	ENDDO
1605	nc_stat = NF90_PUT_VAR( id_set_xz(av), id_var_y_xz(av), netcdf_data, &
1606	start = (/ 1 /), count = (/ ns /) )
1607	CALL handle_netcdf_error( 'netcdf', 163 )
1608
1609	!
1610	!-- Write yv_xz data
1611	DO i = 1, ns
1612	IF( section(i,2) == -1 ) THEN
1613	netcdf_data(i) = -1.0 ! section averaged along y
1614	ELSE
1615	netcdf_data(i) = section(i,2) * dy
1616	ENDIF
1617	ENDDO
1618	nc_stat = NF90_PUT_VAR( id_set_xz(av), id_var_yv_xz(av), &
1619	netcdf_data, start = (/ 1 /), &
1620	count = (/ ns /) )
1621	CALL handle_netcdf_error( 'netcdf', 375 )
1622
1623	!
1624	!-- Write gridpoint number data
1625	netcdf_data(1:ns) = section(1:ns,2)
1626	nc_stat = NF90_PUT_VAR( id_set_xz(av), id_var_ind_y_xz(av), &
1627	netcdf_data, start = (/ 1 /), &
1628	count = (/ ns /) )
1629	CALL handle_netcdf_error( 'netcdf', 164 )
1630
1631
1632	DEALLOCATE( netcdf_data )
1633
1634	!
1635	!-- Write data for x (shifted by +dx/2) and xu axis
1636	ALLOCATE( netcdf_data(0:nx+1) )
1637
1638	DO i = 0, nx+1
1639	netcdf_data(i) = ( i + 0.5 ) * dx
1640	ENDDO
1641
1642	nc_stat = NF90_PUT_VAR( id_set_xz(av), id_var_x_xz(av), netcdf_data, &
1643	start = (/ 1 /), count = (/ nx+2 /) )
1644	CALL handle_netcdf_error( 'netcdf', 165 )
1645
1646	DO i = 0, nx+1
1647	netcdf_data(i) = i * dx
1648	ENDDO
1649
1650	nc_stat = NF90_PUT_VAR( id_set_xz(av), id_var_xu_xz(av), &
1651	netcdf_data, start = (/ 1 /), &
1652	count = (/ nx+2 /) )
1653	CALL handle_netcdf_error( 'netcdf', 377 )
1654
1655	DEALLOCATE( netcdf_data )
1656
1657	!
1658	!-- Write zu and zw data (vertical axes)
1659	ALLOCATE( netcdf_data(0:nz+1) )
1660
1661	netcdf_data(0:nz+1) = zu(nzb:nzt+1)
1662	nc_stat = NF90_PUT_VAR( id_set_xz(av), id_var_zu_xz(av), &
1663	netcdf_data, start = (/ 1 /), &
1664	count = (/ nz+2 /) )
1665	CALL handle_netcdf_error( 'netcdf', 166 )
1666
1667	netcdf_data(0:nz+1) = zw(nzb:nzt+1)
1668	nc_stat = NF90_PUT_VAR( id_set_xz(av), id_var_zw_xz(av), &
1669	netcdf_data, start = (/ 1 /), &
1670	count = (/ nz+2 /) )
1671	CALL handle_netcdf_error( 'netcdf', 167 )
1672
1673	DEALLOCATE( netcdf_data )
1674
1675
1676	CASE ( 'xz_ext' )
1677
1678	!
1679	!-- Get the list of variables and compare with the actual run.
1680	!-- First var_list_old has to be reset, since GET_ATT does not assign
1681	!-- trailing blanks.
1682	var_list_old = ' '
1683	nc_stat = NF90_GET_ATT( id_set_xz(av), NF90_GLOBAL, 'VAR_LIST', &
1684	var_list_old )
1685	CALL handle_netcdf_error( 'netcdf', 168 )
1686
1687	var_list = ';'
1688	i = 1
1689	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
1690	IF ( INDEX( do2d(av,i), 'xz' ) /= 0 ) THEN
1691	netcdf_var_name = do2d(av,i)
1692	CALL clean_netcdf_varname( netcdf_var_name )
1693	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
1694	ENDIF
1695	i = i + 1
1696	ENDDO
1697
1698	IF ( av == 0 ) THEN
1699	var = '(xz)'
1700	ELSE
1701	var = '(xz_av)'
1702	ENDIF
1703
1704	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
1705	message_string = 'NetCDF file for cross-sections ' // &
1706	TRIM( var ) // ' from previous run found,' // &
1707	'& but this file cannot be extended due to' // &
1708	' variable mismatch.' // &
1709	'&New file is created instead.'
1710	CALL message( 'define_netcdf_header', 'PA0249', 0, 1, 0, 6, 0 )
1711	extend = .FALSE.
1712	RETURN
1713	ENDIF
1714
1715	!
1716	!-- Calculate the number of current sections
1717	ns = 1
1718	DO WHILE ( section(ns,2) /= -9999 .AND. ns <= 100 )
1719	ns = ns + 1
1720	ENDDO
1721	ns = ns - 1
1722
1723	!
1724	!-- Get and compare the number of vertical cross sections
1725	nc_stat = NF90_INQ_VARID( id_set_xz(av), 'y_xz', id_var_y_xz(av) )
1726	CALL handle_netcdf_error( 'netcdf', 169 )
1727
1728	nc_stat = NF90_INQUIRE_VARIABLE( id_set_xz(av), id_var_y_xz(av), &
1729	dimids = id_dim_y_xz_old )
1730	CALL handle_netcdf_error( 'netcdf', 170 )
1731	id_dim_y_xz(av) = id_dim_y_xz_old(1)
1732
1733	nc_stat = NF90_INQUIRE_DIMENSION( id_set_xz(av), id_dim_y_xz(av), &
1734	len = ns_old )
1735	CALL handle_netcdf_error( 'netcdf', 171 )
1736
1737	IF ( ns /= ns_old ) THEN
1738	message_string = 'NetCDF file for cross-sections ' // &
1739	TRIM( var ) // ' from previous run found,' // &
1740	'&but this file cannot be extended due to' // &
1741	' mismatch in number of' // &
1742	'&cross sections.' // &
1743	'&New file is created instead.'
1744	CALL message( 'define_netcdf_header', 'PA0250', 0, 1, 0, 6, 0 )
1745	extend = .FALSE.
1746	RETURN
1747	ENDIF
1748
1749	!
1750	!-- Get and compare the heights of the cross sections
1751	ALLOCATE( netcdf_data(1:ns_old) )
1752
1753	nc_stat = NF90_GET_VAR( id_set_xz(av), id_var_y_xz(av), netcdf_data )
1754	CALL handle_netcdf_error( 'netcdf', 172 )
1755
1756	DO i = 1, ns
1757	IF ( section(i,2) /= -1 ) THEN
1758	IF ( ( section(i,2) * dy ) /= netcdf_data(i) ) THEN
1759	message_string = 'NetCDF file for cross-sections ' // &
1760	TRIM( var ) // ' from previous run found,' // &
1761	'&but this file cannot be extended' // &
1762	' due to mismatch in cross' // &
1763	'&section levels.' // &
1764	'&New file is created instead.'
1765	CALL message( 'define_netcdf_header', 'PA0251', &
1766	0, 1, 0, 6, 0 )
1767	extend = .FALSE.
1768	RETURN
1769	ENDIF
1770	ELSE
1771	IF ( -1.0 /= netcdf_data(i) ) THEN
1772	message_string = 'NetCDF file for cross-sections ' // &
1773	TRIM( var ) // ' from previous run found,' // &
1774	'&but this file cannot be extended' // &
1775	' due to mismatch in cross' // &
1776	'&section levels.' // &
1777	'&New file is created instead.'
1778	CALL message( 'define_netcdf_header', 'PA0251', &
1779	0, 1, 0, 6, 0 )
1780	extend = .FALSE.
1781	RETURN
1782	ENDIF
1783	ENDIF
1784	ENDDO
1785
1786	DEALLOCATE( netcdf_data )
1787
1788	!
1789	!-- Get the id of the time coordinate (unlimited coordinate) and its
1790	!-- last index on the file. The next time level is do2d..count+1.
1791	!-- The current time must be larger than the last output time
1792	!-- on the file.
1793	nc_stat = NF90_INQ_VARID( id_set_xz(av), 'time', id_var_time_xz(av) )
1794	CALL handle_netcdf_error( 'netcdf', 173 )
1795
1796	nc_stat = NF90_INQUIRE_VARIABLE( id_set_xz(av), id_var_time_xz(av), &
1797	dimids = id_dim_time_old )
1798	CALL handle_netcdf_error( 'netcdf', 174 )
1799	id_dim_time_xz(av) = id_dim_time_old(1)
1800
1801	nc_stat = NF90_INQUIRE_DIMENSION( id_set_xz(av), id_dim_time_xz(av), &
1802	len = do2d_xz_time_count(av) )
1803	CALL handle_netcdf_error( 'netcdf', 175 )
1804
1805	nc_stat = NF90_GET_VAR( id_set_xz(av), id_var_time_xz(av), &
1806	last_time_coordinate, &
1807	start = (/ do2d_xz_time_count(av) /), &
1808	count = (/ 1 /) )
1809	CALL handle_netcdf_error( 'netcdf', 176 )
1810
1811	IF ( last_time_coordinate(1) >= simulated_time ) THEN
1812	message_string = 'NetCDF file for cross sections ' // &
1813	TRIM( var ) // ' from previous run found,' // &
1814	'&but this file cannot be extended becaus' // &
1815	'e the current output time' // &
1816	'&is less or equal than the last output t' // &
1817	'ime on this file.' // &
1818	'&New file is created instead.'
1819	CALL message( 'define_netcdf_header', 'PA0252', 0, 1, 0, 6, 0 )
1820	do2d_xz_time_count(av) = 0
1821	extend = .FALSE.
1822	RETURN
1823	ENDIF
1824
1825	!
1826	!-- Dataset seems to be extendable.
1827	!-- Now get the variable ids.
1828	i = 1
1829	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
1830	IF ( INDEX( do2d(av,i), 'xz' ) /= 0 ) THEN
1831	netcdf_var_name = do2d(av,i)
1832	CALL clean_netcdf_varname( netcdf_var_name )
1833	nc_stat = NF90_INQ_VARID( id_set_xz(av), netcdf_var_name, &
1834	id_var_do2d(av,i) )
1835	CALL handle_netcdf_error( 'netcdf', 177 )
1836	ENDIF
1837	i = i + 1
1838	ENDDO
1839
1840	!
1841	!-- Update the title attribute on file
1842	!-- In order to avoid 'data mode' errors if updated attributes are larger
1843	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
1844	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
1845	!-- performance loss due to data copying; an alternative strategy would be
1846	!-- to ensure equal attribute size in a job chain. Maybe revise later.
1847	IF ( av == 0 ) THEN
1848	time_average_text = ' '
1849	ELSE
1850	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
1851	averaging_interval
1852	ENDIF
1853	nc_stat = NF90_REDEF( id_set_xz(av) )
1854	CALL handle_netcdf_error( 'netcdf', 433 )
1855	nc_stat = NF90_PUT_ATT( id_set_xz(av), NF90_GLOBAL, 'title', &
1856	TRIM( run_description_header ) // &
1857	TRIM( time_average_text ) )
1858	CALL handle_netcdf_error( 'netcdf', 178 )
1859	nc_stat = NF90_ENDDEF( id_set_xz(av) )
1860	CALL handle_netcdf_error( 'netcdf', 434 )
1861	message_string = 'NetCDF file for cross-sections ' // &
1862	TRIM( var ) // ' from previous run found.' // &
1863	'&This file will be extended.'
1864	CALL message( 'define_netcdf_header', 'PA0253', 0, 0, 0, 6, 0 )
1865
1866
1867	CASE ( 'yz_new' )
1868
1869	!
1870	!-- Define some global attributes of the dataset
1871	nc_stat = NF90_PUT_ATT( id_set_yz(av), NF90_GLOBAL, 'Conventions', &
1872	'COARDS' )
1873	CALL handle_netcdf_error( 'netcdf', 179 )
1874
1875	IF ( av == 0 ) THEN
1876	time_average_text = ' '
1877	ELSE
1878	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
1879	averaging_interval
1880	ENDIF
1881	nc_stat = NF90_PUT_ATT( id_set_yz(av), NF90_GLOBAL, 'title', &
1882	TRIM( run_description_header ) // &
1883	TRIM( time_average_text ) )
1884	CALL handle_netcdf_error( 'netcdf', 180 )
1885	IF ( av == 1 ) THEN
1886	WRITE ( time_average_text,'(F7.1,'' s avg'')' ) averaging_interval
1887	nc_stat = NF90_PUT_ATT( id_set_yz(av), NF90_GLOBAL, 'time_avg', &
1888	TRIM( time_average_text ) )
1889	CALL handle_netcdf_error( 'netcdf', 180 )
1890	ENDIF
1891
1892	!
1893	!-- Define time coordinate for yz sections (unlimited dimension)
1894	nc_stat = NF90_DEF_DIM( id_set_yz(av), 'time', NF90_UNLIMITED, &
1895	id_dim_time_yz(av) )
1896	CALL handle_netcdf_error( 'netcdf', 181 )
1897
1898	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'time', NF90_DOUBLE, &
1899	id_dim_time_yz(av), id_var_time_yz(av) )
1900	CALL handle_netcdf_error( 'netcdf', 182 )
1901
1902	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_time_yz(av), 'units', &
1903	'seconds')
1904	CALL handle_netcdf_error( 'netcdf', 183 )
1905
1906	!
1907	!-- Define the spatial dimensions and coordinates for yz-sections.
1908	!-- First, determine the number of vertical sections to be written.
1909	IF ( section(1,3) == -9999 ) THEN
1910	RETURN
1911	ELSE
1912	ns = 1
1913	DO WHILE ( section(ns,3) /= -9999 .AND. ns <= 100 )
1914	ns = ns + 1
1915	ENDDO
1916	ns = ns - 1
1917	ENDIF
1918
1919	!
1920	!-- Define x axis (for scalar position)
1921	nc_stat = NF90_DEF_DIM( id_set_yz(av), 'x_yz', ns, id_dim_x_yz(av) )
1922	CALL handle_netcdf_error( 'netcdf', 184 )
1923
1924	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'x_yz', NF90_DOUBLE, &
1925	id_dim_x_yz(av), id_var_x_yz(av) )
1926	CALL handle_netcdf_error( 'netcdf', 185 )
1927
1928	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_x_yz(av), 'units', &
1929	'meters' )
1930	CALL handle_netcdf_error( 'netcdf', 186 )
1931
1932	!
1933	!-- Define x axis (for u position)
1934	nc_stat = NF90_DEF_DIM( id_set_yz(av), 'xu_yz', ns, id_dim_xu_yz(av) )
1935	CALL handle_netcdf_error( 'netcdf', 377 )
1936
1937	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'xu_yz', NF90_DOUBLE, &
1938	id_dim_xu_yz(av), id_var_xu_yz(av) )
1939	CALL handle_netcdf_error( 'netcdf', 378 )
1940
1941	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_xu_yz(av), 'units', &
1942	'meters' )
1943	CALL handle_netcdf_error( 'netcdf', 379 )
1944
1945	!
1946	!-- Define a variable to store the layer indices of the vertical cross
1947	!-- sections
1948	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'ind_x_yz', NF90_DOUBLE, &
1949	id_dim_x_yz(av), id_var_ind_x_yz(av) )
1950	CALL handle_netcdf_error( 'netcdf', 187 )
1951
1952	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_ind_x_yz(av), 'units', &
1953	'gridpoints')
1954	CALL handle_netcdf_error( 'netcdf', 188 )
1955
1956	!
1957	!-- Define y-axis (for scalar position)
1958	nc_stat = NF90_DEF_DIM( id_set_yz(av), 'y', ny+2, id_dim_y_yz(av) )
1959	CALL handle_netcdf_error( 'netcdf', 189 )
1960
1961	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'y', NF90_DOUBLE, &
1962	id_dim_y_yz(av), id_var_y_yz(av) )
1963	CALL handle_netcdf_error( 'netcdf', 190 )
1964
1965	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_y_yz(av), 'units', &
1966	'meters' )
1967	CALL handle_netcdf_error( 'netcdf', 191 )
1968
1969	!
1970	!-- Define y-axis (for v position)
1971	nc_stat = NF90_DEF_DIM( id_set_yz(av), 'yv', ny+2, id_dim_yv_yz(av) )
1972	CALL handle_netcdf_error( 'netcdf', 380 )
1973
1974	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'yv', NF90_DOUBLE, &
1975	id_dim_yv_yz(av), id_var_yv_yz(av) )
1976	CALL handle_netcdf_error( 'netcdf', 381 )
1977
1978	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_yv_yz(av), 'units', &
1979	'meters' )
1980	CALL handle_netcdf_error( 'netcdf', 382 )
1981
1982	!
1983	!-- Define the two z-axes (zu and zw)
1984	nc_stat = NF90_DEF_DIM( id_set_yz(av), 'zu', nz+2, id_dim_zu_yz(av) )
1985	CALL handle_netcdf_error( 'netcdf', 192 )
1986
1987	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'zu', NF90_DOUBLE, &
1988	id_dim_zu_yz(av), id_var_zu_yz(av) )
1989	CALL handle_netcdf_error( 'netcdf', 193 )
1990
1991	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_zu_yz(av), 'units', &
1992	'meters' )
1993	CALL handle_netcdf_error( 'netcdf', 194 )
1994
1995	nc_stat = NF90_DEF_DIM( id_set_yz(av), 'zw', nz+2, id_dim_zw_yz(av) )
1996	CALL handle_netcdf_error( 'netcdf', 195 )
1997
1998	nc_stat = NF90_DEF_VAR( id_set_yz(av), 'zw', NF90_DOUBLE, &
1999	id_dim_zw_yz(av), id_var_zw_yz(av) )
2000	CALL handle_netcdf_error( 'netcdf', 196 )
2001
2002	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_zw_yz(av), 'units', &
2003	'meters' )
2004	CALL handle_netcdf_error( 'netcdf', 197 )
2005
2006
2007	!
2008	!-- Define the variables
2009	var_list = ';'
2010	i = 1
2011
2012	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
2013
2014	IF ( INDEX( do2d(av,i), 'yz' ) /= 0 ) THEN
2015
2016	!
2017	!-- Check for the grid
2018	found = .TRUE.
2019	SELECT CASE ( do2d(av,i) )
2020	!
2021	!-- Most variables are defined on the zu grid
2022	CASE ( 'e_yz', 'p_yz', 'pc_yz', 'pr_yz', 'pt_yz', 'q_yz', &
2023	'ql_yz', 'ql_c_yz', 'ql_v_yz', 'ql_vp_yz', 'qv_yz', &
2024	'rho_yz', 's_yz', 'sa_yz', 'vpt_yz' )
2025
2026	grid_x = 'x'
2027	grid_y = 'y'
2028	grid_z = 'zu'
2029	!
2030	!-- u grid
2031	CASE ( 'u_yz' )
2032
2033	grid_x = 'xu'
2034	grid_y = 'y'
2035	grid_z = 'zu'
2036	!
2037	!-- v grid
2038	CASE ( 'v_yz' )
2039
2040	grid_x = 'x'
2041	grid_y = 'yv'
2042	grid_z = 'zu'
2043	!
2044	!-- w grid
2045	CASE ( 'w_yz' )
2046
2047	grid_x = 'x'
2048	grid_y = 'y'
2049	grid_z = 'zw'
2050
2051	CASE DEFAULT
2052	!
2053	!-- Check for user-defined quantities
2054	CALL user_define_netcdf_grid( do2d(av,i), found, &
2055	grid_x, grid_y, grid_z )
2056
2057	END SELECT
2058
2059	!
2060	!-- Select the respective dimension ids
2061	IF ( grid_x == 'x' ) THEN
2062	id_x = id_dim_x_yz(av)
2063	ELSEIF ( grid_x == 'xu' ) THEN
2064	id_x = id_dim_xu_yz(av)
2065	ENDIF
2066
2067	IF ( grid_y == 'y' ) THEN
2068	id_y = id_dim_y_yz(av)
2069	ELSEIF ( grid_y == 'yv' ) THEN
2070	id_y = id_dim_yv_yz(av)
2071	ENDIF
2072
2073	IF ( grid_z == 'zu' ) THEN
2074	id_z = id_dim_zu_yz(av)
2075	ELSEIF ( grid_z == 'zw' ) THEN
2076	id_z = id_dim_zw_yz(av)
2077	ENDIF
2078
2079	!
2080	!-- Define the grid
2081	nc_stat = NF90_DEF_VAR( id_set_yz(av), do2d(av,i), &
2082	nc_precision(3), &
2083	(/ id_x, id_y, id_z, id_dim_time_yz(av) /), &
2084	id_var_do2d(av,i) )
2085
2086	IF ( .NOT. found ) THEN
2087	WRITE ( message_string, * ) 'no grid defined for', &
2088	' variable ', TRIM( do2d(av,i) )
2089	CALL message( 'define_netcdf_header', 'PA0244',&
2090	0, 1, 0, 6, 0 )
2091	ENDIF
2092
2093	var_list = TRIM( var_list ) // TRIM( do2d(av,i) ) // ';'
2094
2095	CALL handle_netcdf_error( 'netcdf', 198 )
2096	!
2097	!-- Store the 'real' name of the variable (with *, for example)
2098	!-- in the long_name attribute. This is evaluated by Ferret,
2099	!-- for example.
2100	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_do2d(av,i), &
2101	'long_name', do2d(av,i) )
2102	CALL handle_netcdf_error( 'netcdf', 199 )
2103	!
2104	!-- Define the variable's unit
2105	nc_stat = NF90_PUT_ATT( id_set_yz(av), id_var_do2d(av,i), &
2106	'units', TRIM( do2d_unit(av,i) ) )
2107	CALL handle_netcdf_error( 'netcdf', 356 )
2108	ENDIF
2109
2110	i = i + 1
2111
2112	ENDDO
2113
2114	!
2115	!-- No arrays to output. Close the netcdf file and return.
2116	IF ( i == 1 ) RETURN
2117
2118	!
2119	!-- Write the list of variables as global attribute (this is used by
2120	!-- restart runs and by combine_plot_fields)
2121	nc_stat = NF90_PUT_ATT( id_set_yz(av), NF90_GLOBAL, 'VAR_LIST', &
2122	var_list )
2123	CALL handle_netcdf_error( 'netcdf', 200 )
2124
2125	!
2126	!-- Leave NetCDF define mode
2127	nc_stat = NF90_ENDDEF( id_set_yz(av) )
2128	CALL handle_netcdf_error( 'netcdf', 201 )
2129
2130	!
2131	!-- Write axis data: x_yz, y, zu, zw
2132	ALLOCATE( netcdf_data(1:ns) )
2133
2134	!
2135	!-- Write x_yz data (shifted by +dx/2)
2136	DO i = 1, ns
2137	IF( section(i,3) == -1 ) THEN
2138	netcdf_data(i) = -1.0 ! section averaged along x
2139	ELSE
2140	netcdf_data(i) = ( section(i,3) + 0.5 ) * dx
2141	ENDIF
2142	ENDDO
2143	nc_stat = NF90_PUT_VAR( id_set_yz(av), id_var_x_yz(av), netcdf_data, &
2144	start = (/ 1 /), count = (/ ns /) )
2145	CALL handle_netcdf_error( 'netcdf', 202 )
2146
2147	!
2148	!-- Write x_yz data (xu grid)
2149	DO i = 1, ns
2150	IF( section(i,3) == -1 ) THEN
2151	netcdf_data(i) = -1.0 ! section averaged along x
2152	ELSE
2153	netcdf_data(i) = section(i,3) * dx
2154	ENDIF
2155	ENDDO
2156	nc_stat = NF90_PUT_VAR( id_set_yz(av), id_var_xu_yz(av), netcdf_data, &
2157	start = (/ 1 /), count = (/ ns /) )
2158	CALL handle_netcdf_error( 'netcdf', 383 )
2159
2160	!
2161	!-- Write gridpoint number data
2162	netcdf_data(1:ns) = section(1:ns,3)
2163	nc_stat = NF90_PUT_VAR( id_set_yz(av), id_var_ind_x_yz(av), &
2164	netcdf_data, start = (/ 1 /), &
2165	count = (/ ns /) )
2166	CALL handle_netcdf_error( 'netcdf', 203 )
2167
2168	DEALLOCATE( netcdf_data )
2169
2170	!
2171	!-- Write data for y (shifted by +dy/2) and yv axis
2172	ALLOCATE( netcdf_data(0:ny+1) )
2173
2174	DO j = 0, ny+1
2175	netcdf_data(j) = ( j + 0.5 ) * dy
2176	ENDDO
2177
2178	nc_stat = NF90_PUT_VAR( id_set_yz(av), id_var_y_yz(av), netcdf_data, &
2179	start = (/ 1 /), count = (/ ny+2 /) )
2180	CALL handle_netcdf_error( 'netcdf', 204 )
2181
2182	DO j = 0, ny+1
2183	netcdf_data(j) = j * dy
2184	ENDDO
2185
2186	nc_stat = NF90_PUT_VAR( id_set_yz(av), id_var_yv_yz(av), &
2187	netcdf_data, start = (/ 1 /), &
2188	count = (/ ny+2 /) )
2189	CALL handle_netcdf_error( 'netcdf', 384 )
2190
2191	DEALLOCATE( netcdf_data )
2192
2193	!
2194	!-- Write zu and zw data (vertical axes)
2195	ALLOCATE( netcdf_data(0:nz+1) )
2196
2197	netcdf_data(0:nz+1) = zu(nzb:nzt+1)
2198	nc_stat = NF90_PUT_VAR( id_set_yz(av), id_var_zu_yz(av), &
2199	netcdf_data, start = (/ 1 /), &
2200	count = (/ nz+2 /) )
2201	CALL handle_netcdf_error( 'netcdf', 205 )
2202
2203	netcdf_data(0:nz+1) = zw(nzb:nzt+1)
2204	nc_stat = NF90_PUT_VAR( id_set_yz(av), id_var_zw_yz(av), &
2205	netcdf_data, start = (/ 1 /), &
2206	count = (/ nz+2 /) )
2207	CALL handle_netcdf_error( 'netcdf', 206 )
2208
2209	DEALLOCATE( netcdf_data )
2210
2211
2212	CASE ( 'yz_ext' )
2213
2214	!
2215	!-- Get the list of variables and compare with the actual run.
2216	!-- First var_list_old has to be reset, since GET_ATT does not assign
2217	!-- trailing blanks.
2218	var_list_old = ' '
2219	nc_stat = NF90_GET_ATT( id_set_yz(av), NF90_GLOBAL, 'VAR_LIST', &
2220	var_list_old )
2221	CALL handle_netcdf_error( 'netcdf', 207 )
2222
2223	var_list = ';'
2224	i = 1
2225	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
2226	IF ( INDEX( do2d(av,i), 'yz' ) /= 0 ) THEN
2227	netcdf_var_name = do2d(av,i)
2228	CALL clean_netcdf_varname( netcdf_var_name )
2229	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
2230	ENDIF
2231	i = i + 1
2232	ENDDO
2233
2234	IF ( av == 0 ) THEN
2235	var = '(yz)'
2236	ELSE
2237	var = '(yz_av)'
2238	ENDIF
2239
2240	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
2241	message_string = 'NetCDF file for cross-sections ' // &
2242	TRIM( var ) // ' from previous run found,' // &
2243	'& but this file cannot be extended due to' // &
2244	' variable mismatch.' // &
2245	'&New file is created instead.'
2246	CALL message( 'define_netcdf_header', 'PA0249', 0, 1, 0, 6, 0 )
2247	extend = .FALSE.
2248	RETURN
2249	ENDIF
2250
2251	!
2252	!-- Calculate the number of current sections
2253	ns = 1
2254	DO WHILE ( section(ns,3) /= -9999 .AND. ns <= 100 )
2255	ns = ns + 1
2256	ENDDO
2257	ns = ns - 1
2258
2259	!
2260	!-- Get and compare the number of vertical cross sections
2261	nc_stat = NF90_INQ_VARID( id_set_yz(av), 'x_yz', id_var_x_yz(av) )
2262	CALL handle_netcdf_error( 'netcdf', 208 )
2263
2264	nc_stat = NF90_INQUIRE_VARIABLE( id_set_yz(av), id_var_x_yz(av), &
2265	dimids = id_dim_x_yz_old )
2266	CALL handle_netcdf_error( 'netcdf', 209 )
2267	id_dim_x_yz(av) = id_dim_x_yz_old(1)
2268
2269	nc_stat = NF90_INQUIRE_DIMENSION( id_set_yz(av), id_dim_x_yz(av), &
2270	len = ns_old )
2271	CALL handle_netcdf_error( 'netcdf', 210 )
2272
2273	IF ( ns /= ns_old ) THEN
2274	message_string = 'NetCDF file for cross-sections ' // &
2275	TRIM( var ) // ' from previous run found,' // &
2276	'&but this file cannot be extended due to' // &
2277	' mismatch in number of' // &
2278	'&cross sections.' // &
2279	'&New file is created instead.'
2280	CALL message( 'define_netcdf_header', 'PA0250', 0, 1, 0, 6, 0 )
2281	extend = .FALSE.
2282	RETURN
2283	ENDIF
2284
2285	!
2286	!-- Get and compare the heights of the cross sections
2287	ALLOCATE( netcdf_data(1:ns_old) )
2288
2289	nc_stat = NF90_GET_VAR( id_set_yz(av), id_var_x_yz(av), netcdf_data )
2290	CALL handle_netcdf_error( 'netcdf', 211 )
2291
2292	DO i = 1, ns
2293	IF ( section(i,3) /= -1 ) THEN
2294	IF ( ( section(i,3) * dx ) /= netcdf_data(i) ) THEN
2295	message_string = 'NetCDF file for cross-sections ' // &
2296	TRIM( var ) // ' from previous run found,' // &
2297	'&but this file cannot be extended' // &
2298	' due to mismatch in cross' // &
2299	'&section levels.' // &
2300	'&New file is created instead.'
2301	CALL message( 'define_netcdf_header', 'PA0251', &
2302	0, 1, 0, 6, 0 )
2303	extend = .FALSE.
2304	RETURN
2305	ENDIF
2306	ELSE
2307	IF ( -1.0 /= netcdf_data(i) ) THEN
2308	message_string = 'NetCDF file for cross-sections ' // &
2309	TRIM( var ) // ' from previous run found,' // &
2310	'&but this file cannot be extended' // &
2311	' due to mismatch in cross' // &
2312	'&section levels.' // &
2313	'&New file is created instead.'
2314	CALL message( 'define_netcdf_header', 'PA0251', &
2315	0, 1, 0, 6, 0 )
2316	extend = .FALSE.
2317	RETURN
2318	ENDIF
2319	ENDIF
2320	ENDDO
2321
2322	DEALLOCATE( netcdf_data )
2323
2324	!
2325	!-- Get the id of the time coordinate (unlimited coordinate) and its
2326	!-- last index on the file. The next time level is pl2d..count+1.
2327	!-- The current time must be larger than the last output time
2328	!-- on the file.
2329	nc_stat = NF90_INQ_VARID( id_set_yz(av), 'time', id_var_time_yz(av) )
2330	CALL handle_netcdf_error( 'netcdf', 212 )
2331
2332	nc_stat = NF90_INQUIRE_VARIABLE( id_set_yz(av), id_var_time_yz(av), &
2333	dimids = id_dim_time_old )
2334	CALL handle_netcdf_error( 'netcdf', 213 )
2335	id_dim_time_yz(av) = id_dim_time_old(1)
2336
2337	nc_stat = NF90_INQUIRE_DIMENSION( id_set_yz(av), id_dim_time_yz(av), &
2338	len = do2d_yz_time_count(av) )
2339	CALL handle_netcdf_error( 'netcdf', 214 )
2340
2341	nc_stat = NF90_GET_VAR( id_set_yz(av), id_var_time_yz(av), &
2342	last_time_coordinate, &
2343	start = (/ do2d_yz_time_count(av) /), &
2344	count = (/ 1 /) )
2345	CALL handle_netcdf_error( 'netcdf', 215 )
2346
2347	IF ( last_time_coordinate(1) >= simulated_time ) THEN
2348	message_string = 'NetCDF file for cross sections ' // &
2349	TRIM( var ) // ' from previous run found,' // &
2350	'&but this file cannot be extended becaus' // &
2351	'e the current output time' // &
2352	'&is less or equal than the last output t' // &
2353	'ime on this file.' // &
2354	'&New file is created instead.'
2355	CALL message( 'define_netcdf_header', 'PA0252', 0, 1, 0, 6, 0 )
2356	do2d_yz_time_count(av) = 0
2357	extend = .FALSE.
2358	RETURN
2359	ENDIF
2360
2361	!
2362	!-- Dataset seems to be extendable.
2363	!-- Now get the variable ids.
2364	i = 1
2365	DO WHILE ( do2d(av,i)(1:1) /= ' ' )
2366	IF ( INDEX( do2d(av,i), 'yz' ) /= 0 ) THEN
2367	netcdf_var_name = do2d(av,i)
2368	CALL clean_netcdf_varname( netcdf_var_name )
2369	nc_stat = NF90_INQ_VARID( id_set_yz(av), netcdf_var_name, &
2370	id_var_do2d(av,i) )
2371	CALL handle_netcdf_error( 'netcdf', 216 )
2372	ENDIF
2373	i = i + 1
2374	ENDDO
2375
2376	!
2377	!-- Update the title attribute on file
2378	!-- In order to avoid 'data mode' errors if updated attributes are larger
2379	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
2380	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
2381	!-- performance loss due to data copying; an alternative strategy would be
2382	!-- to ensure equal attribute size in a job chain. Maybe revise later.
2383	IF ( av == 0 ) THEN
2384	time_average_text = ' '
2385	ELSE
2386	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
2387	averaging_interval
2388	ENDIF
2389	nc_stat = NF90_REDEF( id_set_yz(av) )
2390	CALL handle_netcdf_error( 'netcdf', 435 )
2391	nc_stat = NF90_PUT_ATT( id_set_yz(av), NF90_GLOBAL, 'title', &
2392	TRIM( run_description_header ) // &
2393	TRIM( time_average_text ) )
2394	CALL handle_netcdf_error( 'netcdf', 217 )
2395	nc_stat = NF90_ENDDEF( id_set_yz(av) )
2396	CALL handle_netcdf_error( 'netcdf', 436 )
2397	message_string = 'NetCDF file for cross-sections ' // &
2398	TRIM( var ) // ' from previous run found.' // &
2399	'&This file will be extended.'
2400	CALL message( 'define_netcdf_header', 'PA0253', 0, 0, 0, 6, 0 )
2401
2402
2403	CASE ( 'pr_new' )
2404
2405	!
2406	!-- Define some global attributes of the dataset
2407	IF ( averaging_interval_pr /= 0.0 ) THEN
2408	WRITE (time_average_text,'('', '',F7.1,'' s average'')') &
2409	averaging_interval_pr
2410	nc_stat = NF90_PUT_ATT( id_set_pr, NF90_GLOBAL, 'title', &
2411	TRIM( run_description_header ) // &
2412	TRIM( time_average_text ) )
2413	CALL handle_netcdf_error( 'netcdf', 218 )
2414
2415	WRITE ( time_average_text,'(F7.1,'' s avg'')' ) averaging_interval_pr
2416	nc_stat = NF90_PUT_ATT( id_set_pr, NF90_GLOBAL, 'time_avg', &
2417	TRIM( time_average_text ) )
2418	ELSE
2419	nc_stat = NF90_PUT_ATT( id_set_pr, NF90_GLOBAL, 'title', &
2420	TRIM( run_description_header ) )
2421	ENDIF
2422	CALL handle_netcdf_error( 'netcdf', 219 )
2423
2424	!
2425	!-- Define time coordinate for profiles (unlimited dimension)
2426	nc_stat = NF90_DEF_DIM( id_set_pr, 'time', NF90_UNLIMITED, &
2427	id_dim_time_pr )
2428	CALL handle_netcdf_error( 'netcdf', 220 )
2429
2430	nc_stat = NF90_DEF_VAR( id_set_pr, 'time', NF90_DOUBLE, &
2431	id_dim_time_pr, id_var_time_pr )
2432	CALL handle_netcdf_error( 'netcdf', 221 )
2433
2434	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_time_pr, 'units', 'seconds')
2435	CALL handle_netcdf_error( 'netcdf', 222 )
2436
2437	!
2438	!-- Define the variables
2439	var_list = ';'
2440	DO i = 1, dopr_n
2441	!
2442	!-- First, remove those characters not allowed by NetCDF
2443	netcdf_var_name = data_output_pr(i)
2444	CALL clean_netcdf_varname( netcdf_var_name )
2445
2446	IF ( statistic_regions == 0 ) THEN
2447
2448	!
2449	!-- Define the z-axes (each variable gets its own z-axis)
2450	nc_stat = NF90_DEF_DIM( id_set_pr, 'z'//TRIM(netcdf_var_name), &
2451	nzt+2-nzb, id_dim_z_pr(i,0) )
2452	CALL handle_netcdf_error( 'netcdf', 223 )
2453
2454	nc_stat = NF90_DEF_VAR( id_set_pr, 'z'//TRIM(netcdf_var_name), &
2455	NF90_DOUBLE, id_dim_z_pr(i,0), &
2456	id_var_z_pr(i,0) )
2457	CALL handle_netcdf_error( 'netcdf', 224 )
2458
2459	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_z_pr(i,0), 'units', &
2460	'meters' )
2461	CALL handle_netcdf_error( 'netcdf', 225 )
2462	!
2463	!-- Define the variable
2464	nc_stat = NF90_DEF_VAR( id_set_pr, netcdf_var_name, &
2465	nc_precision(5), (/ id_dim_z_pr(i,0), &
2466	id_dim_time_pr /), id_var_dopr(i,0) )
2467	CALL handle_netcdf_error( 'netcdf', 226 )
2468
2469	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_dopr(i,0), &
2470	'long_name', TRIM( data_output_pr(i) ) )
2471	CALL handle_netcdf_error( 'netcdf', 227 )
2472
2473	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_dopr(i,0), &
2474	'units', TRIM( dopr_unit(i) ) )
2475	CALL handle_netcdf_error( 'netcdf', 228 )
2476
2477	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
2478
2479	ELSE
2480	!
2481	!-- If statistic regions are defined, add suffix _SR+#SR to the
2482	!-- names
2483	DO j = 0, statistic_regions
2484	WRITE ( suffix, '(''_'',I1)' ) j
2485
2486	!
2487	!-- Define the z-axes (each variable gets it own z-axis)
2488	nc_stat = NF90_DEF_DIM( id_set_pr, &
2489	'z'//TRIM(netcdf_var_name)//suffix, &
2490	nzt+2-nzb, id_dim_z_pr(i,j) )
2491	CALL handle_netcdf_error( 'netcdf', 229 )
2492
2493	nc_stat = NF90_DEF_VAR( id_set_pr, &
2494	'z'//TRIM(netcdf_var_name)//suffix, &
2495	nc_precision(5), id_dim_z_pr(i,j), &
2496	id_var_z_pr(i,j) )
2497	CALL handle_netcdf_error( 'netcdf', 230 )
2498
2499	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_z_pr(i,j), &
2500	'units', 'meters' )
2501	CALL handle_netcdf_error( 'netcdf', 231 )
2502
2503	!
2504	!-- Define the variable
2505	nc_stat = NF90_DEF_VAR( id_set_pr, &
2506	TRIM( netcdf_var_name ) // suffix, &
2507	nc_precision(5), &
2508	(/ id_dim_z_pr(i,j), &
2509	id_dim_time_pr /), id_var_dopr(i,j) )
2510	CALL handle_netcdf_error( 'netcdf', 232 )
2511
2512	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_dopr(i,j), &
2513	'long_name', &
2514	TRIM( data_output_pr(i) ) // ' SR ' &
2515	// suffix(2:2) )
2516	CALL handle_netcdf_error( 'netcdf', 233 )
2517
2518	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_dopr(i,j), &
2519	'units', TRIM( dopr_unit(i) ) )
2520	CALL handle_netcdf_error( 'netcdf', 234 )
2521
2522	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // &
2523	suffix // ';'
2524
2525	ENDDO
2526
2527	ENDIF
2528
2529	ENDDO
2530
2531	!
2532	!-- Write the list of variables as global attribute (this is used by
2533	!-- restart runs)
2534	nc_stat = NF90_PUT_ATT( id_set_pr, NF90_GLOBAL, 'VAR_LIST', var_list )
2535	CALL handle_netcdf_error( 'netcdf', 235 )
2536
2537	!
2538	!-- Define normalization variables (as time series)
2539	DO i = 1, dopr_norm_num
2540
2541	nc_stat = NF90_DEF_VAR( id_set_pr, 'NORM_' // &
2542	TRIM( dopr_norm_names(i) ), &
2543	nc_precision(5), (/ id_dim_time_pr /), &
2544	id_var_norm_dopr(i) )
2545	CALL handle_netcdf_error( 'netcdf', 236 )
2546
2547	nc_stat = NF90_PUT_ATT( id_set_pr, id_var_norm_dopr(i), &
2548	'long_name', &
2549	TRIM( dopr_norm_longnames(i) ) )
2550	CALL handle_netcdf_error( 'netcdf', 237 )
2551
2552	ENDDO
2553
2554	!
2555	!-- Leave NetCDF define mode
2556	nc_stat = NF90_ENDDEF( id_set_pr )
2557	CALL handle_netcdf_error( 'netcdf', 238 )
2558
2559	!
2560	!-- Write z-axes data
2561	DO i = 1, dopr_n
2562	DO j = 0, statistic_regions
2563
2564	nc_stat = NF90_PUT_VAR( id_set_pr, id_var_z_pr(i,j), &
2565	hom(nzb:nzt+1,2,dopr_index(i),0), &
2566	start = (/ 1 /), &
2567	count = (/ nzt-nzb+2 /) )
2568	CALL handle_netcdf_error( 'netcdf', 239 )
2569
2570	ENDDO
2571	ENDDO
2572
2573
2574	CASE ( 'pr_ext' )
2575
2576	!
2577	!-- Get the list of variables and compare with the actual run.
2578	!-- First var_list_old has to be reset, since GET_ATT does not assign
2579	!-- trailing blanks.
2580	var_list_old = ' '
2581	nc_stat = NF90_GET_ATT( id_set_pr, NF90_GLOBAL, 'VAR_LIST', &
2582	var_list_old )
2583	CALL handle_netcdf_error( 'netcdf', 240 )
2584
2585	var_list = ';'
2586	DO i = 1, dopr_n
2587
2588	netcdf_var_name = data_output_pr(i)
2589	CALL clean_netcdf_varname( netcdf_var_name )
2590
2591	IF ( statistic_regions == 0 ) THEN
2592	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
2593	ELSE
2594	DO j = 0, statistic_regions
2595	WRITE ( suffix, '(''_'',I1)' ) j
2596	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // &
2597	suffix // ';'
2598	ENDDO
2599	ENDIF
2600
2601	ENDDO
2602
2603	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
2604	message_string = 'NetCDF file for vertical profiles ' // &
2605	'from previous run found,' // &
2606	'& but this file cannot be extended due to' // &
2607	' variable mismatch.' // &
2608	'&New file is created instead.'
2609	CALL message( 'define_netcdf_header', 'PA0254', 0, 1, 0, 6, 0 )
2610	extend = .FALSE.
2611	RETURN
2612	ENDIF
2613
2614	!
2615	!-- Get the id of the time coordinate (unlimited coordinate) and its
2616	!-- last index on the file. The next time level is dopr..count+1.
2617	!-- The current time must be larger than the last output time
2618	!-- on the file.
2619	nc_stat = NF90_INQ_VARID( id_set_pr, 'time', id_var_time_pr )
2620	CALL handle_netcdf_error( 'netcdf', 241 )
2621
2622	nc_stat = NF90_INQUIRE_VARIABLE( id_set_pr, id_var_time_pr, &
2623	dimids = id_dim_time_old )
2624	CALL handle_netcdf_error( 'netcdf', 242 )
2625	id_dim_time_pr = id_dim_time_old(1)
2626
2627	nc_stat = NF90_INQUIRE_DIMENSION( id_set_pr, id_dim_time_pr, &
2628	len = dopr_time_count )
2629	CALL handle_netcdf_error( 'netcdf', 243 )
2630
2631	nc_stat = NF90_GET_VAR( id_set_pr, id_var_time_pr, &
2632	last_time_coordinate, &
2633	start = (/ dopr_time_count /), &
2634	count = (/ 1 /) )
2635	CALL handle_netcdf_error( 'netcdf', 244 )
2636
2637	IF ( last_time_coordinate(1) >= simulated_time ) THEN
2638	message_string = 'NetCDF file for vertical profiles ' // &
2639	'from previous run found,' // &
2640	'&but this file cannot be extended becaus' // &
2641	'e the current output time' // &
2642	'&is less or equal than the last output t' // &
2643	'ime on this file.' // &
2644	'&New file is created instead.'
2645	CALL message( 'define_netcdf_header', 'PA0255', 0, 1, 0, 6, 0 )
2646	dopr_time_count = 0
2647	extend = .FALSE.
2648	RETURN
2649	ENDIF
2650
2651	!
2652	!-- Dataset seems to be extendable.
2653	!-- Now get the variable ids.
2654	i = 1
2655	DO i = 1, dopr_n
2656
2657	netcdf_var_name_base = data_output_pr(i)
2658	CALL clean_netcdf_varname( netcdf_var_name_base )
2659
2660	IF ( statistic_regions == 0 ) THEN
2661	nc_stat = NF90_INQ_VARID( id_set_pr, netcdf_var_name_base, &
2662	id_var_dopr(i,0) )
2663	CALL handle_netcdf_error( 'netcdf', 245 )
2664	ELSE
2665	DO j = 0, statistic_regions
2666	WRITE ( suffix, '(''_'',I1)' ) j
2667	netcdf_var_name = TRIM( netcdf_var_name_base ) // suffix
2668	nc_stat = NF90_INQ_VARID( id_set_pr, netcdf_var_name, &
2669	id_var_dopr(i,j) )
2670	CALL handle_netcdf_error( 'netcdf', 246 )
2671	ENDDO
2672	ENDIF
2673
2674	ENDDO
2675
2676	!
2677	!-- Get ids of the normalization variables
2678	DO i = 1, dopr_norm_num
2679	nc_stat = NF90_INQ_VARID( id_set_pr, &
2680	'NORM_' // TRIM( dopr_norm_names(i) ), &
2681	id_var_norm_dopr(i) )
2682	CALL handle_netcdf_error( 'netcdf', 247 )
2683	ENDDO
2684
2685	!
2686	!-- Update the title attribute on file
2687	!-- In order to avoid 'data mode' errors if updated attributes are larger
2688	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
2689	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
2690	!-- performance loss due to data copying; an alternative strategy would be
2691	!-- to ensure equal attribute size in a job chain. Maybe revise later.
2692	IF ( averaging_interval_pr == 0.0 ) THEN
2693	time_average_text = ' '
2694	ELSE
2695	WRITE (time_average_text, '('', '',F7.1,'' s average'')') &
2696	averaging_interval_pr
2697	ENDIF
2698	nc_stat = NF90_REDEF( id_set_pr )
2699	CALL handle_netcdf_error( 'netcdf', 437 )
2700	nc_stat = NF90_PUT_ATT( id_set_pr, NF90_GLOBAL, 'title', &
2701	TRIM( run_description_header ) // &
2702	TRIM( time_average_text ) )
2703	CALL handle_netcdf_error( 'netcdf', 248 )
2704	nc_stat = NF90_ENDDEF( id_set_pr )
2705	CALL handle_netcdf_error( 'netcdf', 438 )
2706	message_string = 'NetCDF file for vertical profiles ' // &
2707	'from previous run found.' // &
2708	'&This file will be extended.'
2709	CALL message( 'define_netcdf_header', 'PA0256', 0, 0, 0, 6, 0 )
2710
2711
2712	CASE ( 'ts_new' )
2713
2714	!
2715	!-- Define some global attributes of the dataset
2716	nc_stat = NF90_PUT_ATT( id_set_ts, NF90_GLOBAL, 'title', &
2717	TRIM( run_description_header ) )
2718	CALL handle_netcdf_error( 'netcdf', 249 )
2719
2720	!
2721	!-- Define time coordinate for time series (unlimited dimension)
2722	nc_stat = NF90_DEF_DIM( id_set_ts, 'time', NF90_UNLIMITED, &
2723	id_dim_time_ts )
2724	CALL handle_netcdf_error( 'netcdf', 250 )
2725
2726	nc_stat = NF90_DEF_VAR( id_set_ts, 'time', NF90_DOUBLE, &
2727	id_dim_time_ts, id_var_time_ts )
2728	CALL handle_netcdf_error( 'netcdf', 251 )
2729
2730	nc_stat = NF90_PUT_ATT( id_set_ts, id_var_time_ts, 'units', 'seconds')
2731	CALL handle_netcdf_error( 'netcdf', 252 )
2732
2733	!
2734	!-- Define the variables
2735	var_list = ';'
2736	DO i = 1, dots_num
2737	!
2738	!-- First, remove those characters not allowed by NetCDF
2739	netcdf_var_name = dots_label(i)
2740	CALL clean_netcdf_varname( netcdf_var_name )
2741
2742	IF ( statistic_regions == 0 ) THEN
2743
2744	nc_stat = NF90_DEF_VAR( id_set_ts, netcdf_var_name, &
2745	nc_precision(6), (/ id_dim_time_ts /), &
2746	id_var_dots(i,0) )
2747	CALL handle_netcdf_error( 'netcdf', 253 )
2748
2749	nc_stat = NF90_PUT_ATT( id_set_ts, id_var_dots(i,0), &
2750	'long_name', TRIM( dots_label(i) ) )
2751	CALL handle_netcdf_error( 'netcdf', 254 )
2752
2753	nc_stat = NF90_PUT_ATT( id_set_ts, id_var_dots(i,0), &
2754	'units', TRIM( dots_unit(i) ) )
2755	CALL handle_netcdf_error( 'netcdf', 255 )
2756
2757	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
2758
2759	ELSE
2760	!
2761	!-- If statistic regions are defined, add suffix _SR+#SR to the
2762	!-- names
2763	DO j = 0, statistic_regions
2764	WRITE ( suffix, '(''_'',I1)' ) j
2765
2766	nc_stat = NF90_DEF_VAR( id_set_ts, &
2767	TRIM( netcdf_var_name ) // suffix, &
2768	nc_precision(6), &
2769	(/ id_dim_time_ts /), &
2770	id_var_dots(i,j) )
2771	CALL handle_netcdf_error( 'netcdf', 256 )
2772
2773	nc_stat = NF90_PUT_ATT( id_set_ts, id_var_dots(i,j), &
2774	'long_name', &
2775	TRIM( dots_label(i) ) // ' SR ' // &
2776	suffix(2:2) )
2777	CALL handle_netcdf_error( 'netcdf', 257 )
2778
2779	nc_stat = NF90_PUT_ATT( id_set_ts, id_var_dots(i,j), &
2780	'units', TRIM( dots_unit(i) ) )
2781	CALL handle_netcdf_error( 'netcdf', 347 )
2782
2783	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // &
2784	suffix // ';'
2785
2786	ENDDO
2787
2788	ENDIF
2789
2790	ENDDO
2791
2792	!
2793	!-- Write the list of variables as global attribute (this is used by
2794	!-- restart runs)
2795	nc_stat = NF90_PUT_ATT( id_set_ts, NF90_GLOBAL, 'VAR_LIST', var_list )
2796	CALL handle_netcdf_error( 'netcdf', 258 )
2797
2798	!
2799	!-- Leave NetCDF define mode
2800	nc_stat = NF90_ENDDEF( id_set_ts )
2801	CALL handle_netcdf_error( 'netcdf', 259 )
2802
2803
2804	CASE ( 'ts_ext' )
2805
2806	!
2807	!-- Get the list of variables and compare with the actual run.
2808	!-- First var_list_old has to be reset, since GET_ATT does not assign
2809	!-- trailing blanks.
2810	var_list_old = ' '
2811	nc_stat = NF90_GET_ATT( id_set_ts, NF90_GLOBAL, 'VAR_LIST', &
2812	var_list_old )
2813	CALL handle_netcdf_error( 'netcdf', 260 )
2814
2815	var_list = ';'
2816	i = 1
2817	DO i = 1, dots_num
2818
2819	netcdf_var_name = dots_label(i)
2820	CALL clean_netcdf_varname( netcdf_var_name )
2821
2822	IF ( statistic_regions == 0 ) THEN
2823	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // ';'
2824	ELSE
2825	DO j = 0, statistic_regions
2826	WRITE ( suffix, '(''_'',I1)' ) j
2827	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // &
2828	suffix // ';'
2829	ENDDO
2830	ENDIF
2831
2832	ENDDO
2833
2834	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
2835	message_string = 'NetCDF file for time series ' // &
2836	'from previous run found,' // &
2837	'& but this file cannot be extended due to' // &
2838	' variable mismatch.' // &
2839	'&New file is created instead.'
2840	CALL message( 'define_netcdf_header', 'PA0257', 0, 1, 0, 6, 0 )
2841	extend = .FALSE.
2842	RETURN
2843	ENDIF
2844
2845	!
2846	!-- Get the id of the time coordinate (unlimited coordinate) and its
2847	!-- last index on the file. The next time level is dots..count+1.
2848	!-- The current time must be larger than the last output time
2849	!-- on the file.
2850	nc_stat = NF90_INQ_VARID( id_set_ts, 'time', id_var_time_ts )
2851	CALL handle_netcdf_error( 'netcdf', 261 )
2852
2853	nc_stat = NF90_INQUIRE_VARIABLE( id_set_ts, id_var_time_ts, &
2854	dimids = id_dim_time_old )
2855	CALL handle_netcdf_error( 'netcdf', 262 )
2856	id_dim_time_ts = id_dim_time_old(1)
2857
2858	nc_stat = NF90_INQUIRE_DIMENSION( id_set_ts, id_dim_time_ts, &
2859	len = dots_time_count )
2860	CALL handle_netcdf_error( 'netcdf', 263 )
2861
2862	nc_stat = NF90_GET_VAR( id_set_ts, id_var_time_ts, &
2863	last_time_coordinate, &
2864	start = (/ dots_time_count /), &
2865	count = (/ 1 /) )
2866	CALL handle_netcdf_error( 'netcdf', 264 )
2867
2868	IF ( last_time_coordinate(1) >= simulated_time ) THEN
2869	message_string = 'NetCDF file for time series ' // &
2870	'from previous run found,' // &
2871	'&but this file cannot be extended becaus' // &
2872	'e the current output time' // &
2873	'&is less or equal than the last output t' // &
2874	'ime on this file.' // &
2875	'&New file is created instead.'
2876	CALL message( 'define_netcdf_header', 'PA0258', 0, 1, 0, 6, 0 )
2877	dots_time_count = 0
2878	extend = .FALSE.
2879	RETURN
2880	ENDIF
2881
2882	!
2883	!-- Dataset seems to be extendable.
2884	!-- Now get the variable ids
2885	i = 1
2886	DO i = 1, dots_num
2887
2888	netcdf_var_name_base = dots_label(i)
2889	CALL clean_netcdf_varname( netcdf_var_name_base )
2890
2891	IF ( statistic_regions == 0 ) THEN
2892	nc_stat = NF90_INQ_VARID( id_set_ts, netcdf_var_name_base, &
2893	id_var_dots(i,0) )
2894	CALL handle_netcdf_error( 'netcdf', 265 )
2895	ELSE
2896	DO j = 0, statistic_regions
2897	WRITE ( suffix, '(''_'',I1)' ) j
2898	netcdf_var_name = TRIM( netcdf_var_name_base ) // suffix
2899	nc_stat = NF90_INQ_VARID( id_set_ts, netcdf_var_name, &
2900	id_var_dots(i,j) )
2901	CALL handle_netcdf_error( 'netcdf', 266 )
2902	ENDDO
2903	ENDIF
2904
2905	ENDDO
2906
2907	!
2908	!-- Update the title attribute on file
2909	!-- In order to avoid 'data mode' errors if updated attributes are larger
2910	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
2911	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
2912	!-- performance loss due to data copying; an alternative strategy would be
2913	!-- to ensure equal attribute size in a job chain. Maybe revise later.
2914	nc_stat = NF90_REDEF( id_set_ts )
2915	CALL handle_netcdf_error( 'netcdf', 439 )
2916	nc_stat = NF90_PUT_ATT( id_set_ts, NF90_GLOBAL, 'title', &
2917	TRIM( run_description_header ) )
2918	CALL handle_netcdf_error( 'netcdf', 267 )
2919	nc_stat = NF90_ENDDEF( id_set_ts )
2920	CALL handle_netcdf_error( 'netcdf', 440 )
2921	message_string = 'NetCDF file for time series ' // &
2922	'from previous run found.' // &
2923	'&This file will be extended.'
2924	CALL message( 'define_netcdf_header', 'PA0259', 0, 0, 0, 6, 0 )
2925
2926
2927	CASE ( 'sp_new' )
2928
2929	!
2930	!-- Define some global attributes of the dataset
2931	IF ( averaging_interval_sp /= 0.0 ) THEN
2932	WRITE (time_average_text,'('', '',F7.1,'' s average'')') &
2933	averaging_interval_sp
2934	nc_stat = NF90_PUT_ATT( id_set_sp, NF90_GLOBAL, 'title', &
2935	TRIM( run_description_header ) // &
2936	TRIM( time_average_text ) )
2937	CALL handle_netcdf_error( 'netcdf', 268 )
2938
2939	WRITE ( time_average_text,'(F7.1,'' s avg'')' ) averaging_interval_sp
2940	nc_stat = NF90_PUT_ATT( id_set_sp, NF90_GLOBAL, 'time_avg', &
2941	TRIM( time_average_text ) )
2942	ELSE
2943	nc_stat = NF90_PUT_ATT( id_set_sp, NF90_GLOBAL, 'title', &
2944	TRIM( run_description_header ) )
2945	ENDIF
2946	CALL handle_netcdf_error( 'netcdf', 269 )
2947
2948	!
2949	!-- Define time coordinate for spectra (unlimited dimension)
2950	nc_stat = NF90_DEF_DIM( id_set_sp, 'time', NF90_UNLIMITED, &
2951	id_dim_time_sp )
2952	CALL handle_netcdf_error( 'netcdf', 270 )
2953
2954	nc_stat = NF90_DEF_VAR( id_set_sp, 'time', NF90_DOUBLE, &
2955	id_dim_time_sp, id_var_time_sp )
2956	CALL handle_netcdf_error( 'netcdf', 271 )
2957
2958	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_time_sp, 'units', 'seconds')
2959	CALL handle_netcdf_error( 'netcdf', 272 )
2960
2961	!
2962	!-- Define the spatial dimensions and coordinates for spectra.
2963	!-- First, determine the number of vertical levels for which spectra
2964	!-- are to be output.
2965	ns = 1
2966	DO WHILE ( comp_spectra_level(ns) /= 999999 .AND. ns <= 100 )
2967	ns = ns + 1
2968	ENDDO
2969	ns = ns - 1
2970
2971	!
2972	!-- Define vertical coordinate grid (zu grid)
2973	nc_stat = NF90_DEF_DIM( id_set_sp, 'zu_sp', ns, id_dim_zu_sp )
2974	CALL handle_netcdf_error( 'netcdf', 273 )
2975
2976	nc_stat = NF90_DEF_VAR( id_set_sp, 'zu_sp', NF90_DOUBLE, &
2977	id_dim_zu_sp, id_var_zu_sp )
2978	CALL handle_netcdf_error( 'netcdf', 274 )
2979
2980	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_zu_sp, 'units', 'meters' )
2981	CALL handle_netcdf_error( 'netcdf', 275 )
2982
2983	!
2984	!-- Define vertical coordinate grid (zw grid)
2985	nc_stat = NF90_DEF_DIM( id_set_sp, 'zw_sp', ns, id_dim_zw_sp )
2986	CALL handle_netcdf_error( 'netcdf', 276 )
2987
2988	nc_stat = NF90_DEF_VAR( id_set_sp, 'zw_sp', NF90_DOUBLE, &
2989	id_dim_zw_sp, id_var_zw_sp )
2990	CALL handle_netcdf_error( 'netcdf', 277 )
2991
2992	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_zw_sp, 'units', 'meters' )
2993	CALL handle_netcdf_error( 'netcdf', 278 )
2994
2995	!
2996	!-- Define x-axis
2997	nc_stat = NF90_DEF_DIM( id_set_sp, 'k_x', nx/2, id_dim_x_sp )
2998	CALL handle_netcdf_error( 'netcdf', 279 )
2999
3000	nc_stat = NF90_DEF_VAR( id_set_sp, 'k_x', NF90_DOUBLE, id_dim_x_sp, &
3001	id_var_x_sp )
3002	CALL handle_netcdf_error( 'netcdf', 280 )
3003
3004	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_x_sp, 'units', 'm-1' )
3005	CALL handle_netcdf_error( 'netcdf', 281 )
3006
3007	!
3008	!-- Define y-axis
3009	nc_stat = NF90_DEF_DIM( id_set_sp, 'k_y', ny/2, id_dim_y_sp )
3010	CALL handle_netcdf_error( 'netcdf', 282 )
3011
3012	nc_stat = NF90_DEF_VAR( id_set_sp, 'k_y', NF90_DOUBLE, id_dim_y_sp, &
3013	id_var_y_sp )
3014	CALL handle_netcdf_error( 'netcdf', 283 )
3015
3016	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_y_sp, 'units', 'm-1' )
3017	CALL handle_netcdf_error( 'netcdf', 284 )
3018
3019	!
3020	!-- Define the variables
3021	var_list = ';'
3022	i = 1
3023	DO WHILE ( data_output_sp(i) /= ' ' .AND. i <= 10 )
3024	!
3025	!-- First check for the vertical grid
3026	found = .TRUE.
3027	SELECT CASE ( data_output_sp(i) )
3028	!
3029	!-- Most variables are defined on the zu levels
3030	CASE ( 'e', 'p', 'pc', 'pr', 'pt', 'q', 'ql', 'ql_c', 'ql_v', &
3031	'ql_vp', 'qv', 'rho', 's', 'sa', 'u', 'v', 'vpt' )
3032
3033	grid_z = 'zu'
3034	!
3035	!-- zw levels
3036	CASE ( 'w' )
3037
3038	grid_z = 'zw'
3039
3040	CASE DEFAULT
3041	!
3042	!-- Check for user-defined quantities (found, grid_x and grid_y
3043	!-- are dummies)
3044	CALL user_define_netcdf_grid( data_output_sp(i), found, &
3045	grid_x, grid_y, grid_z )
3046
3047	END SELECT
3048
3049	IF ( INDEX( spectra_direction(i), 'x' ) /= 0 ) THEN
3050
3051	!
3052	!-- Define the variable
3053	netcdf_var_name = TRIM( data_output_sp(i) ) // '_x'
3054	CALL clean_netcdf_varname( netcdf_var_name )
3055	IF ( TRIM( grid_z ) == 'zw' ) THEN
3056	nc_stat = NF90_DEF_VAR( id_set_sp, netcdf_var_name, &
3057	nc_precision(7), (/ id_dim_x_sp, &
3058	id_dim_zw_sp, id_dim_time_sp /), &
3059	id_var_dospx(i) )
3060	ELSE
3061	nc_stat = NF90_DEF_VAR( id_set_sp, netcdf_var_name, &
3062	nc_precision(7), (/ id_dim_x_sp, &
3063	id_dim_zu_sp, id_dim_time_sp /), &
3064	id_var_dospx(i) )
3065	ENDIF
3066	CALL handle_netcdf_error( 'netcdf', 285 )
3067
3068	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_dospx(i), &
3069	'long_name', netcdf_var_name )
3070	CALL handle_netcdf_error( 'netcdf', 286 )
3071
3072	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_dospx(i), &
3073	'units', 'unknown' )
3074	CALL handle_netcdf_error( 'netcdf', 287 )
3075
3076	var_list = TRIM( var_list ) // TRIM( netcdf_var_name ) // ';'
3077
3078	ENDIF
3079
3080	IF ( INDEX( spectra_direction(i), 'y' ) /= 0 ) THEN
3081
3082	!
3083	!-- Define the variable
3084	netcdf_var_name = TRIM( data_output_sp(i) ) // '_y'
3085	CALL clean_netcdf_varname( netcdf_var_name )
3086	IF ( TRIM( grid_z ) == 'zw' ) THEN
3087	nc_stat = NF90_DEF_VAR( id_set_sp, netcdf_var_name, &
3088	nc_precision(7), (/ id_dim_y_sp, &
3089	id_dim_zw_sp, id_dim_time_sp /), &
3090	id_var_dospy(i) )
3091	ELSE
3092	nc_stat = NF90_DEF_VAR( id_set_sp, netcdf_var_name, &
3093	nc_precision(7), (/ id_dim_y_sp, &
3094	id_dim_zu_sp, id_dim_time_sp /), &
3095	id_var_dospy(i) )
3096	ENDIF
3097	CALL handle_netcdf_error( 'netcdf', 288 )
3098
3099	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_dospy(i), &
3100	'long_name', netcdf_var_name )
3101	CALL handle_netcdf_error( 'netcdf', 289 )
3102
3103	nc_stat = NF90_PUT_ATT( id_set_sp, id_var_dospy(i), &
3104	'units', 'unknown' )
3105	CALL handle_netcdf_error( 'netcdf', 290 )
3106
3107	var_list = TRIM( var_list ) // TRIM( netcdf_var_name ) // ';'
3108
3109	ENDIF
3110
3111	i = i + 1
3112
3113	ENDDO
3114
3115	!
3116	!-- Write the list of variables as global attribute (this is used by
3117	!-- restart runs)
3118	nc_stat = NF90_PUT_ATT( id_set_sp, NF90_GLOBAL, 'VAR_LIST', var_list )
3119	CALL handle_netcdf_error( 'netcdf', 291 )
3120
3121	!
3122	!-- Leave NetCDF define mode
3123	nc_stat = NF90_ENDDEF( id_set_sp )
3124	CALL handle_netcdf_error( 'netcdf', 292 )
3125
3126	!
3127	!-- Write axis data: zu_sp, zw_sp, k_x, k_y
3128	ALLOCATE( netcdf_data(1:ns) )
3129
3130	!
3131	!-- Write zu data
3132	netcdf_data(1:ns) = zu( comp_spectra_level(1:ns) )
3133	nc_stat = NF90_PUT_VAR( id_set_sp, id_var_zu_sp, netcdf_data, &
3134	start = (/ 1 /), count = (/ ns /) )
3135	CALL handle_netcdf_error( 'netcdf', 293 )
3136
3137	!
3138	!-- Write zw data
3139	netcdf_data(1:ns) = zw( comp_spectra_level(1:ns) )
3140	nc_stat = NF90_PUT_VAR( id_set_sp, id_var_zw_sp, netcdf_data, &
3141	start = (/ 1 /), count = (/ ns /) )
3142	CALL handle_netcdf_error( 'netcdf', 294 )
3143
3144	DEALLOCATE( netcdf_data )
3145
3146	!
3147	!-- Write data for x and y axis (wavenumbers)
3148	ALLOCATE( netcdf_data(nx/2) )
3149	DO i = 1, nx/2
3150	netcdf_data(i) = 2.0 * pi * i / ( dx * ( nx + 1 ) )
3151	ENDDO
3152
3153	nc_stat = NF90_PUT_VAR( id_set_sp, id_var_x_sp, netcdf_data, &
3154	start = (/ 1 /), count = (/ nx/2 /) )
3155	CALL handle_netcdf_error( 'netcdf', 295 )
3156
3157	DEALLOCATE( netcdf_data )
3158
3159	ALLOCATE( netcdf_data(ny/2) )
3160	DO i = 1, ny/2
3161	netcdf_data(i) = 2.0 * pi * i / ( dy * ( ny + 1 ) )
3162	ENDDO
3163
3164	nc_stat = NF90_PUT_VAR( id_set_sp, id_var_y_sp, netcdf_data, &
3165	start = (/ 1 /), count = (/ ny/2 /) )
3166	CALL handle_netcdf_error( 'netcdf', 296 )
3167
3168	DEALLOCATE( netcdf_data )
3169
3170
3171	CASE ( 'sp_ext' )
3172
3173	!
3174	!-- Get the list of variables and compare with the actual run.
3175	!-- First var_list_old has to be reset, since GET_ATT does not assign
3176	!-- trailing blanks.
3177	var_list_old = ' '
3178	nc_stat = NF90_GET_ATT( id_set_sp, NF90_GLOBAL, 'VAR_LIST', &
3179	var_list_old )
3180	CALL handle_netcdf_error( 'netcdf', 297 )
3181	var_list = ';'
3182	i = 1
3183	DO WHILE ( data_output_sp(i) /= ' ' .AND. i <= 10 )
3184
3185	IF ( INDEX( spectra_direction(i), 'x' ) /= 0 ) THEN
3186	netcdf_var_name = TRIM( data_output_sp(i) ) // '_x'
3187	var_list = TRIM( var_list ) // TRIM( netcdf_var_name ) // ';'
3188	ENDIF
3189
3190	IF ( INDEX( spectra_direction(i), 'y' ) /= 0 ) THEN
3191	netcdf_var_name = TRIM( data_output_sp(i) ) // '_y'
3192	var_list = TRIM( var_list ) // TRIM( netcdf_var_name ) // ';'
3193	ENDIF
3194
3195	i = i + 1
3196
3197	ENDDO
3198
3199	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
3200	message_string = 'NetCDF file for spectra ' // &
3201	'from previous run found,' // &
3202	'& but this file cannot be extended due to' // &
3203	' variable mismatch.' // &
3204	'&New file is created instead.'
3205	CALL message( 'define_netcdf_header', 'PA0260', 0, 1, 0, 6, 0 )
3206	extend = .FALSE.
3207	RETURN
3208	ENDIF
3209
3210	!
3211	!-- Determine the number of current vertical levels for which spectra
3212	!-- shall be output
3213	ns = 1
3214	DO WHILE ( comp_spectra_level(ns) /= 999999 .AND. ns <= 100 )
3215	ns = ns + 1
3216	ENDDO
3217	ns = ns - 1
3218
3219	!
3220	!-- Get and compare the number of vertical levels
3221	nc_stat = NF90_INQ_VARID( id_set_sp, 'zu_sp', id_var_zu_sp )
3222	CALL handle_netcdf_error( 'netcdf', 298 )
3223
3224	nc_stat = NF90_INQUIRE_VARIABLE( id_set_sp, id_var_zu_sp, &
3225	dimids = id_dim_zu_sp_old )
3226	CALL handle_netcdf_error( 'netcdf', 299 )
3227	id_dim_zu_sp = id_dim_zu_sp_old(1)
3228
3229	nc_stat = NF90_INQUIRE_DIMENSION( id_set_sp, id_dim_zu_sp, &
3230	len = ns_old )
3231	CALL handle_netcdf_error( 'netcdf', 300 )
3232
3233	IF ( ns /= ns_old ) THEN
3234	message_string = 'NetCDF file for spectra ' // &
3235	' from previous run found,' // &
3236	'&but this file cannot be extended due to' // &
3237	' mismatch in number of' // &
3238	'&vertical levels.' // &
3239	'&New file is created instead.'
3240	CALL message( 'define_netcdf_header', 'PA0261', 0, 1, 0, 6, 0 )
3241	extend = .FALSE.
3242	RETURN
3243	ENDIF
3244
3245	!
3246	!-- Get and compare the heights of the cross sections
3247	ALLOCATE( netcdf_data(1:ns_old) )
3248
3249	nc_stat = NF90_GET_VAR( id_set_sp, id_var_zu_sp, netcdf_data )
3250	CALL handle_netcdf_error( 'netcdf', 301 )
3251
3252	DO i = 1, ns
3253	IF ( zu(comp_spectra_level(i)) /= netcdf_data(i) ) THEN
3254	message_string = 'NetCDF file for spectra ' // &
3255	' from previous run found,' // &
3256	'&but this file cannot be extended due to' // &
3257	' mismatch in heights of' // &
3258	'&vertical levels.' // &
3259	'&New file is created instead.'
3260	CALL message( 'define_netcdf_header', 'PA0262', 0, 1, 0, 6, 0 )
3261	extend = .FALSE.
3262	RETURN
3263	ENDIF
3264	ENDDO
3265
3266	DEALLOCATE( netcdf_data )
3267
3268	!
3269	!-- Get the id of the time coordinate (unlimited coordinate) and its
3270	!-- last index on the file. The next time level is plsp..count+1.
3271	!-- The current time must be larger than the last output time
3272	!-- on the file.
3273	nc_stat = NF90_INQ_VARID( id_set_sp, 'time', id_var_time_sp )
3274	CALL handle_netcdf_error( 'netcdf', 302 )
3275
3276	nc_stat = NF90_INQUIRE_VARIABLE( id_set_sp, id_var_time_sp, &
3277	dimids = id_dim_time_old )
3278	CALL handle_netcdf_error( 'netcdf', 303 )
3279	id_dim_time_sp = id_dim_time_old(1)
3280
3281	nc_stat = NF90_INQUIRE_DIMENSION( id_set_sp, id_dim_time_sp, &
3282	len = dosp_time_count )
3283	CALL handle_netcdf_error( 'netcdf', 304 )
3284
3285	nc_stat = NF90_GET_VAR( id_set_sp, id_var_time_sp, &
3286	last_time_coordinate, &
3287	start = (/ dosp_time_count /), &
3288	count = (/ 1 /) )
3289	CALL handle_netcdf_error( 'netcdf', 305 )
3290
3291	IF ( last_time_coordinate(1) >= simulated_time ) THEN
3292	message_string = 'NetCDF file for spectra ' // &
3293	'from previous run found,' // &
3294	'&but this file cannot be extended becaus' // &
3295	'e the current output time' // &
3296	'&is less or equal than the last output t' // &
3297	'ime on this file.' // &
3298	'&New file is created instead.'
3299	CALL message( 'define_netcdf_header', 'PA0263', 0, 1, 0, 6, 0 )
3300	dosp_time_count = 0
3301	extend = .FALSE.
3302	RETURN
3303	ENDIF
3304
3305	!
3306	!-- Dataset seems to be extendable.
3307	!-- Now get the variable ids.
3308	i = 1
3309	DO WHILE ( data_output_sp(i) /= ' ' .AND. i <= 10 )
3310
3311	IF ( INDEX( spectra_direction(i), 'x' ) /= 0 ) THEN
3312	netcdf_var_name = TRIM( data_output_sp(i) ) // '_x'
3313	nc_stat = NF90_INQ_VARID( id_set_sp, netcdf_var_name, &
3314	id_var_dospx(i) )
3315	CALL handle_netcdf_error( 'netcdf', 306 )
3316	ENDIF
3317
3318	IF ( INDEX( spectra_direction(i), 'y' ) /= 0 ) THEN
3319	netcdf_var_name = TRIM( data_output_sp(i) ) // '_y'
3320	nc_stat = NF90_INQ_VARID( id_set_sp, netcdf_var_name, &
3321	id_var_dospy(i) )
3322	CALL handle_netcdf_error( 'netcdf', 307 )
3323	ENDIF
3324
3325	i = i + 1
3326
3327	ENDDO
3328
3329	!
3330	!-- Update the title attribute on file
3331	!-- In order to avoid 'data mode' errors if updated attributes are larger
3332	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
3333	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
3334	!-- performance loss due to data copying; an alternative strategy would be
3335	!-- to ensure equal attribute size in a job chain. Maybe revise later.
3336	nc_stat = NF90_REDEF( id_set_sp )
3337	CALL handle_netcdf_error( 'netcdf', 441 )
3338	IF ( averaging_interval_sp /= 0.0 ) THEN
3339	WRITE (time_average_text,'('', '',F7.1,'' s average'')') &
3340	averaging_interval_sp
3341	nc_stat = NF90_PUT_ATT( id_set_sp, NF90_GLOBAL, 'title', &
3342	TRIM( run_description_header ) // &
3343	TRIM( time_average_text ) )
3344	CALL handle_netcdf_error( 'netcdf', 308 )
3345
3346	WRITE ( time_average_text,'(F7.1,'' s avg'')' ) averaging_interval_sp
3347	nc_stat = NF90_PUT_ATT( id_set_sp, NF90_GLOBAL, 'time_avg', &
3348	TRIM( time_average_text ) )
3349	ELSE
3350	nc_stat = NF90_PUT_ATT( id_set_sp, NF90_GLOBAL, 'title', &
3351	TRIM( run_description_header ) )
3352	ENDIF
3353	CALL handle_netcdf_error( 'netcdf', 309 )
3354	nc_stat = NF90_ENDDEF( id_set_sp )
3355	CALL handle_netcdf_error( 'netcdf', 442 )
3356	message_string = 'NetCDF file for spectra ' // &
3357	'from previous run found.' // &
3358	'&This file will be extended.'
3359	CALL message( 'define_netcdf_header', 'PA0264', 0, 0, 0, 6, 0 )
3360
3361
3362	CASE ( 'pt_new' )
3363
3364	!
3365	!-- Define some global attributes of the dataset
3366	nc_stat = NF90_PUT_ATT( id_set_prt, NF90_GLOBAL, 'title', &
3367	TRIM( run_description_header ) )
3368	CALL handle_netcdf_error( 'netcdf', 310 )
3369
3370	!
3371	!-- Define time coordinate for particles (unlimited dimension)
3372	nc_stat = NF90_DEF_DIM( id_set_prt, 'time', NF90_UNLIMITED, &
3373	id_dim_time_prt )
3374	CALL handle_netcdf_error( 'netcdf', 311 )
3375
3376	nc_stat = NF90_DEF_VAR( id_set_prt, 'time', NF90_DOUBLE, &
3377	id_dim_time_prt, id_var_time_prt )
3378	CALL handle_netcdf_error( 'netcdf', 312 )
3379
3380	nc_stat = NF90_PUT_ATT( id_set_prt, id_var_time_prt, 'units', &
3381	'seconds' )
3382	CALL handle_netcdf_error( 'netcdf', 313 )
3383
3384	!
3385	!-- Define particle coordinate (maximum particle number)
3386	nc_stat = NF90_DEF_DIM( id_set_prt, 'particle_number', &
3387	maximum_number_of_particles, id_dim_prtnum )
3388	CALL handle_netcdf_error( 'netcdf', 314 )
3389
3390	nc_stat = NF90_DEF_VAR( id_set_prt, 'particle_number', NF90_DOUBLE, &
3391	id_dim_prtnum, id_var_prtnum )
3392	CALL handle_netcdf_error( 'netcdf', 315 )
3393
3394	nc_stat = NF90_PUT_ATT( id_set_prt, id_var_prtnum, 'units', &
3395	'particle number' )
3396	CALL handle_netcdf_error( 'netcdf', 316 )
3397
3398	!
3399	!-- Define variable which contains the real number of particles in use
3400	nc_stat = NF90_DEF_VAR( id_set_prt, 'real_num_of_prt', NF90_INT, &
3401	id_dim_time_prt, id_var_rnop_prt )
3402	CALL handle_netcdf_error( 'netcdf', 317 )
3403
3404	nc_stat = NF90_PUT_ATT( id_set_prt, id_var_rnop_prt, 'units', &
3405	'particle number' )
3406	CALL handle_netcdf_error( 'netcdf', 318 )
3407
3408	!
3409	!-- Define the variables
3410	DO i = 1, 17
3411
3412	nc_stat = NF90_DEF_VAR( id_set_prt, prt_var_names(i), &
3413	nc_precision(8), &
3414	(/ id_dim_prtnum, id_dim_time_prt /), &
3415	id_var_prt(i) )
3416	CALL handle_netcdf_error( 'netcdf', 319 )
3417
3418	nc_stat = NF90_PUT_ATT( id_set_prt, id_var_prt(i), &
3419	'long_name', TRIM( prt_var_names(i) ) )
3420	CALL handle_netcdf_error( 'netcdf', 320 )
3421
3422	nc_stat = NF90_PUT_ATT( id_set_prt, id_var_prt(i), &
3423	'units', TRIM( prt_var_units(i) ) )
3424	CALL handle_netcdf_error( 'netcdf', 321 )
3425
3426	ENDDO
3427
3428	!
3429	!-- Leave NetCDF define mode
3430	nc_stat = NF90_ENDDEF( id_set_prt )
3431	CALL handle_netcdf_error( 'netcdf', 322 )
3432
3433
3434	CASE ( 'pt_ext' )
3435
3436	!
3437	!-- Get the id of the time coordinate (unlimited coordinate) and its
3438	!-- last index on the file. The next time level is prt..count+1.
3439	!-- The current time must be larger than the last output time
3440	!-- on the file.
3441	nc_stat = NF90_INQ_VARID( id_set_prt, 'time', id_var_time_prt )
3442	CALL handle_netcdf_error( 'netcdf', 323 )
3443
3444	nc_stat = NF90_INQUIRE_VARIABLE( id_set_prt, id_var_time_prt, &
3445	dimids = id_dim_time_old )
3446	CALL handle_netcdf_error( 'netcdf', 324 )
3447	id_dim_time_prt = id_dim_time_old(1)
3448
3449	nc_stat = NF90_INQUIRE_DIMENSION( id_set_prt, id_dim_time_prt, &
3450	len = prt_time_count )
3451	CALL handle_netcdf_error( 'netcdf', 325 )
3452
3453	nc_stat = NF90_GET_VAR( id_set_prt, id_var_time_prt, &
3454	last_time_coordinate, &
3455	start = (/ prt_time_count /), &
3456	count = (/ 1 /) )
3457	CALL handle_netcdf_error( 'netcdf', 326 )
3458
3459	IF ( last_time_coordinate(1) >= simulated_time ) THEN
3460	message_string = 'NetCDF file for particles ' // &
3461	'from previous run found,' // &
3462	'&but this file cannot be extended becaus' // &
3463	'e the current output time' // &
3464	'&is less or equal than the last output t' // &
3465	'ime on this file.' // &
3466	'&New file is created instead.'
3467	CALL message( 'define_netcdf_header', 'PA0265', 0, 1, 0, 6, 0 )
3468	prt_time_count = 0
3469	extend = .FALSE.
3470	RETURN
3471	ENDIF
3472
3473	!
3474	!-- Dataset seems to be extendable.
3475	!-- Now get the variable ids.
3476	nc_stat = NF90_INQ_VARID( id_set_prt, 'real_num_of_prt', &
3477	id_var_rnop_prt )
3478	CALL handle_netcdf_error( 'netcdf', 327 )
3479
3480	DO i = 1, 17
3481
3482	nc_stat = NF90_INQ_VARID( id_set_prt, prt_var_names(i), &
3483	id_var_prt(i) )
3484	CALL handle_netcdf_error( 'netcdf', 328 )
3485
3486	ENDDO
3487
3488	message_string = 'NetCDF file for particles ' // &
3489	'from previous run found.' // &
3490	'&This file will be extended.'
3491	CALL message( 'define_netcdf_header', 'PA0266', 0, 0, 0, 6, 0 )
3492
3493
3494
3495	CASE ( 'ps_new' )
3496
3497	!
3498	!-- Define some global attributes of the dataset
3499	nc_stat = NF90_PUT_ATT( id_set_pts, NF90_GLOBAL, 'title', &
3500	TRIM( run_description_header ) )
3501	CALL handle_netcdf_error( 'netcdf', 396 )
3502
3503	!
3504	!-- Define time coordinate for particle time series (unlimited dimension)
3505	nc_stat = NF90_DEF_DIM( id_set_pts, 'time', NF90_UNLIMITED, &
3506	id_dim_time_pts )
3507	CALL handle_netcdf_error( 'netcdf', 397 )
3508
3509	nc_stat = NF90_DEF_VAR( id_set_pts, 'time', NF90_DOUBLE, &
3510	id_dim_time_pts, id_var_time_pts )
3511	CALL handle_netcdf_error( 'netcdf', 398 )
3512
3513	nc_stat = NF90_PUT_ATT( id_set_pts, id_var_time_pts, 'units', &
3514	'seconds')
3515	CALL handle_netcdf_error( 'netcdf', 399 )
3516
3517	!
3518	!-- Define the variables. If more than one particle group is defined,
3519	!-- define seperate variables for each group
3520	var_list = ';'
3521	DO i = 1, dopts_num
3522
3523	!
3524	!-- First, remove those characters not allowed by NetCDF
3525	netcdf_var_name = dopts_label(i)
3526	CALL clean_netcdf_varname( netcdf_var_name )
3527
3528	DO j = 0, number_of_particle_groups
3529
3530	IF ( j == 0 ) THEN
3531	suffix1 = ''
3532	ELSE
3533	WRITE ( suffix1, '(''_'',I2.2)' ) j
3534	ENDIF
3535
3536	nc_stat = NF90_DEF_VAR( id_set_pts, &
3537	TRIM( netcdf_var_name ) // suffix1, &
3538	nc_precision(6), &
3539	(/ id_dim_time_pts /), &
3540	id_var_dopts(i,j) )
3541	CALL handle_netcdf_error( 'netcdf', 400 )
3542
3543	IF ( j == 0 ) THEN
3544	nc_stat = NF90_PUT_ATT( id_set_pts, id_var_dopts(i,j), &
3545	'long_name', &
3546	TRIM( dopts_label(i) ) )
3547	ELSE
3548	nc_stat = NF90_PUT_ATT( id_set_pts, id_var_dopts(i,j), &
3549	'long_name', &
3550	TRIM( dopts_label(i) ) // ' PG ' // &
3551	suffix1(2:3) )
3552	ENDIF
3553	CALL handle_netcdf_error( 'netcdf', 401 )
3554
3555	nc_stat = NF90_PUT_ATT( id_set_pts, id_var_dopts(i,j), &
3556	'units', TRIM( dopts_unit(i) ) )
3557	CALL handle_netcdf_error( 'netcdf', 402 )
3558
3559	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // &
3560	suffix1 // ';'
3561
3562	IF ( number_of_particle_groups == 1 ) EXIT
3563
3564	ENDDO
3565
3566	ENDDO
3567
3568	!
3569	!-- Write the list of variables as global attribute (this is used by
3570	!-- restart runs)
3571	nc_stat = NF90_PUT_ATT( id_set_pts, NF90_GLOBAL, 'VAR_LIST', &
3572	var_list )
3573	CALL handle_netcdf_error( 'netcdf', 403 )
3574
3575
3576	!
3577	!-- Leave NetCDF define mode
3578	nc_stat = NF90_ENDDEF( id_set_pts )
3579	CALL handle_netcdf_error( 'netcdf', 404 )
3580
3581
3582	CASE ( 'ps_ext' )
3583
3584	!
3585	!-- Get the list of variables and compare with the actual run.
3586	!-- First var_list_old has to be reset, since GET_ATT does not assign
3587	!-- trailing blanks.
3588	var_list_old = ' '
3589	nc_stat = NF90_GET_ATT( id_set_pts, NF90_GLOBAL, 'VAR_LIST', &
3590	var_list_old )
3591	CALL handle_netcdf_error( 'netcdf', 405 )
3592
3593	var_list = ';'
3594	i = 1
3595	DO i = 1, dopts_num
3596
3597	netcdf_var_name = dopts_label(i)
3598	CALL clean_netcdf_varname( netcdf_var_name )
3599
3600	DO j = 0, number_of_particle_groups
3601
3602	IF ( j == 0 ) THEN
3603	suffix1 = ''
3604	ELSE
3605	WRITE ( suffix1, '(''_'',I2.2)' ) j
3606	ENDIF
3607
3608	var_list = TRIM(var_list) // TRIM(netcdf_var_name) // &
3609	suffix1 // ';'
3610
3611	IF ( number_of_particle_groups == 1 ) EXIT
3612
3613	ENDDO
3614
3615	ENDDO
3616
3617	IF ( TRIM( var_list ) /= TRIM( var_list_old ) ) THEN
3618	message_string = 'NetCDF file for particle time series ' // &
3619	'from previous run found,' // &
3620	'& but this file cannot be extended due to' // &
3621	' variable mismatch.' // &
3622	'&New file is created instead.'
3623	CALL message( 'define_netcdf_header', 'PA0267', 0, 1, 0, 6, 0 )
3624	extend = .FALSE.
3625	RETURN
3626	ENDIF
3627
3628	!
3629	!-- Get the id of the time coordinate (unlimited coordinate) and its
3630	!-- last index on the file. The next time level is dots..count+1.
3631	!-- The current time must be larger than the last output time
3632	!-- on the file.
3633	nc_stat = NF90_INQ_VARID( id_set_pts, 'time', id_var_time_pts )
3634	CALL handle_netcdf_error( 'netcdf', 406 )
3635
3636	nc_stat = NF90_INQUIRE_VARIABLE( id_set_pts, id_var_time_pts, &
3637	dimids = id_dim_time_old )
3638	CALL handle_netcdf_error( 'netcdf', 407 )
3639	id_dim_time_pts = id_dim_time_old(1)
3640
3641	nc_stat = NF90_INQUIRE_DIMENSION( id_set_pts, id_dim_time_pts, &
3642	len = dopts_time_count )
3643	CALL handle_netcdf_error( 'netcdf', 408 )
3644
3645	nc_stat = NF90_GET_VAR( id_set_pts, id_var_time_pts, &
3646	last_time_coordinate, &
3647	start = (/ dopts_time_count /), &
3648	count = (/ 1 /) )
3649	CALL handle_netcdf_error( 'netcdf', 409 )
3650
3651	IF ( last_time_coordinate(1) >= simulated_time ) THEN
3652	message_string = 'NetCDF file for particle time series ' // &
3653	'from previous run found,' // &
3654	'&but this file cannot be extended becaus' // &
3655	'e the current output time' // &
3656	'&is less or equal than the last output t' // &
3657	'ime on this file.' // &
3658	'&New file is created instead.'
3659	CALL message( 'define_netcdf_header', 'PA0268', 0, 1, 0, 6, 0 )
3660	dopts_time_count = 0
3661	extend = .FALSE.
3662	RETURN
3663	ENDIF
3664
3665	!
3666	!-- Dataset seems to be extendable.
3667	!-- Now get the variable ids
3668	i = 1
3669	DO i = 1, dopts_num
3670
3671	netcdf_var_name_base = dopts_label(i)
3672	CALL clean_netcdf_varname( netcdf_var_name_base )
3673
3674	DO j = 0, number_of_particle_groups
3675
3676	IF ( j == 0 ) THEN
3677	suffix1 = ''
3678	ELSE
3679	WRITE ( suffix1, '(''_'',I2.2)' ) j
3680	ENDIF
3681
3682	netcdf_var_name = TRIM( netcdf_var_name_base ) // suffix1
3683
3684	nc_stat = NF90_INQ_VARID( id_set_pts, netcdf_var_name, &
3685	id_var_dopts(i,j) )
3686	CALL handle_netcdf_error( 'netcdf', 410 )
3687
3688	IF ( number_of_particle_groups == 1 ) EXIT
3689
3690	ENDDO
3691
3692	ENDDO
3693
3694	!
3695	!-- Update the title attribute on file
3696	!-- In order to avoid 'data mode' errors if updated attributes are larger
3697	!-- than their original size, NF90_PUT_ATT is called in 'define mode'
3698	!-- enclosed by NF90_REDEF and NF90_ENDDEF calls. This implies a possible
3699	!-- performance loss due to data copying; an alternative strategy would be
3700	!-- to ensure equal attribute size in a job chain. Maybe revise later.
3701	nc_stat = NF90_REDEF( id_set_pts )
3702	CALL handle_netcdf_error( 'netcdf', 443 )
3703	nc_stat = NF90_PUT_ATT( id_set_pts, NF90_GLOBAL, 'title', &
3704	TRIM( run_description_header ) )
3705	CALL handle_netcdf_error( 'netcdf', 411 )
3706	nc_stat = NF90_ENDDEF( id_set_pts )
3707	CALL handle_netcdf_error( 'netcdf', 444 )
3708	message_string = 'NetCDF file for particle time series ' // &
3709	'from previous run found.' // &
3710	'&This file will be extended.'
3711	CALL message( 'define_netcdf_header', 'PA0269', 0, 0, 0, 6, 0 )
3712
3713
3714	CASE DEFAULT
3715
3716	message_string = 'mode "' // TRIM( mode) // '" not supported'
3717	CALL message( 'define_netcdf_header', 'PA0270', 0, 0, 0, 6, 0 )
3718
3719	END SELECT
3720
3721	#endif
3722	END SUBROUTINE define_netcdf_header
3723
3724
3725	SUBROUTINE handle_netcdf_error( routine_name, errno )
3726	#if defined( __netcdf )
3727
3728	!------------------------------------------------------------------------------!
3729	!
3730	! Description:
3731	! ------------
3732	! Prints out a text message corresponding to the current status.
3733	!------------------------------------------------------------------------------!
3734
3735	USE control_parameters
3736	USE netcdf
3737	USE netcdf_control
3738	USE pegrid
3739
3740	IMPLICIT NONE
3741
3742	CHARACTER(LEN=6) :: message_identifier
3743	CHARACTER(LEN=*) :: routine_name
3744
3745	INTEGER :: errno
3746
3747	IF ( nc_stat /= NF90_NOERR ) THEN
3748
3749	WRITE( message_identifier, '(''NC'',I4.4)' ) errno
3750	message_string = TRIM( NF90_STRERROR( nc_stat ) )
3751
3752	CALL message( routine_name, message_identifier, 2, 2, 0, 6, 1 )
3753
3754	ENDIF
3755
3756	#endif
3757	END SUBROUTINE handle_netcdf_error
3758
3759
3760
3761	SUBROUTINE clean_netcdf_varname( string )
3762	#if defined( __netcdf )
3763
3764	!------------------------------------------------------------------------------!
3765	!
3766	! Description:
3767	! ------------
3768	! Replace those characters in string which are not allowed by NetCDF.
3769	!------------------------------------------------------------------------------!
3770
3771	USE netcdf_control
3772
3773	IMPLICIT NONE
3774
3775	CHARACTER (LEN=10), INTENT(INOUT) :: string
3776
3777	INTEGER :: i, ic
3778
3779	DO i = 1, replace_num
3780	DO
3781	ic = INDEX( string, replace_char(i) )
3782	IF ( ic /= 0 ) THEN
3783	string(ic:ic) = replace_by(i)
3784	ELSE
3785	EXIT
3786	ENDIF
3787	ENDDO
3788	ENDDO
3789
3790	#endif
3791	END SUBROUTINE clean_netcdf_varname

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: palm/trunk/SOURCE/netcdf.f90 @ 397

Download in other formats: