source: palm/trunk/SOURCE/eqn_state_seawater.f90 @ 392

Last change on this file since 392 was 392, checked in by raasch, 12 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: 7.8 KB
Line 
1 MODULE eqn_state_seawater_mod
2
3!------------------------------------------------------------------------------!
4! Actual revisions:
5! -----------------
6!
7!
8! Former revisions:
9! -----------------
10! $Id: eqn_state_seawater.f90 392 2009-09-24 10:39:14Z raasch $
11!
12! 388 2009-09-23 09:40:33Z raasch
13! Potential density is additionally calculated in eqn_state_seawater,
14! first constant in array den also defined as type double.
15!
16! 97 2007-06-21 08:23:15Z raasch
17! Initial revision
18!
19!
20! Description:
21! ------------
22! Equation of state for seawater as a function of potential temperature,
23! salinity, and pressure.
24! For coefficients see Jackett et al., 2006: J. Atm. Ocean Tech.
25! eqn_state_seawater calculates the potential density referred at hyp(0).
26! eqn_state_seawater_func calculates density.
27!------------------------------------------------------------------------------!
28
29    IMPLICIT NONE
30
31    PRIVATE
32    PUBLIC eqn_state_seawater, eqn_state_seawater_func
33
34    REAL, DIMENSION(12), PARAMETER ::  nom =                             &
35                      (/ 9.9984085444849347D2,   7.3471625860981584D0,   &
36                        -5.3211231792841769D-2,  3.6492439109814549D-4,  &
37                         2.5880571023991390D0,  -6.7168282786692354D-3,  &
38                         1.9203202055760151D-3,  1.1798263740430364D-2,  &
39                         9.8920219266399117D-8,  4.6996642771754730D-6,  &
40                        -2.5862187075154352D-8, -3.2921414007960662D-12 /)
41
42    REAL, DIMENSION(13), PARAMETER ::  den =                             &
43                      (/ 1.0D0,                  7.2815210113327091D-3,  &
44                        -4.4787265461983921D-5,  3.3851002965802430D-7,  &
45                         1.3651202389758572D-10, 1.7632126669040377D-3,  &
46                        -8.8066583251206474D-6, -1.8832689434804897D-10, &
47                         5.7463776745432097D-6,  1.4716275472242334D-9,  &
48                         6.7103246285651894D-6, -2.4461698007024582D-17, &
49                        -9.1534417604289062D-18 /)
50
51    INTERFACE eqn_state_seawater
52       MODULE PROCEDURE eqn_state_seawater
53       MODULE PROCEDURE eqn_state_seawater_ij
54    END INTERFACE eqn_state_seawater
55 
56    INTERFACE eqn_state_seawater_func
57       MODULE PROCEDURE eqn_state_seawater_func
58    END INTERFACE eqn_state_seawater_func
59 
60 CONTAINS
61
62
63!------------------------------------------------------------------------------!
64! Call for all grid points
65!------------------------------------------------------------------------------!
66    SUBROUTINE eqn_state_seawater
67
68       USE arrays_3d
69       USE indices
70
71       IMPLICIT NONE
72
73       INTEGER ::  i, j, k
74
75       REAL ::  pden, pnom, p1, p2, p3, pt1, pt2, pt3, pt4, sa1, sa15, sa2
76
77       DO  i = nxl, nxr
78          DO  j = nys, nyn
79             DO  k = nzb_s_inner(j,i)+1, nzt
80!
81!--             Pressure is needed in dbar
82                p1 = hyp(k) * 1E-4
83                p2 = p1 * p1
84                p3 = p2 * p1
85
86!
87!--             Temperature needed in degree Celsius
88                pt1 = pt_p(k,j,i) - 273.15
89                pt2 = pt1 * pt1
90                pt3 = pt1 * pt2
91                pt4 = pt2 * pt2
92
93                sa1  = sa_p(k,j,i)
94                sa15 = sa1 * SQRT( sa1 )
95                sa2  = sa1 * sa1
96
97                pnom = nom(1)           + nom(2)*pt1     + nom(3)*pt2     + &
98                       nom(4)*pt3       + nom(5)*sa1     + nom(6)*sa1*pt1 + &
99                       nom(7)*sa2
100
101                pden = den(1)           + den(2)*pt1     + den(3)*pt2     + &
102                       den(4)*pt3       + den(5)*pt4     + den(6)*sa1     + &
103                       den(7)*sa1*pt1   + den(8)*sa1*pt3 + den(9)*sa15    + &
104                       den(10)*sa15*pt2
105
106!
107!--             Potential density (without pressure terms)
108                prho(k,j,i) = pnom / pden
109
110                pnom = pnom +             nom(8)*p1      + nom(9)*p1*pt2  + &
111                       nom(10)*p1*sa1   + nom(11)*p2     + nom(12)*p2*pt2
112
113                pden = pden +             den(11)*p1     + den(12)*p2*pt3 + &
114                       den(13)*p3*pt1
115
116!
117!--             In-situ density
118                rho(k,j,i) = pnom / pden
119
120             ENDDO
121!
122!--          Neumann conditions are assumed at bottom and top boundary
123             prho(nzt+1,j,i)            = prho(nzt,j,i)
124             prho(nzb_s_inner(j,i),j,i) = prho(nzb_s_inner(j,i)+1,j,i)
125             rho(nzt+1,j,i)             = rho(nzt,j,i)
126             rho(nzb_s_inner(j,i),j,i)  = rho(nzb_s_inner(j,i)+1,j,i)
127
128          ENDDO
129       ENDDO
130
131    END SUBROUTINE eqn_state_seawater
132
133
134!------------------------------------------------------------------------------!
135! Call for grid point i,j
136!------------------------------------------------------------------------------!
137    SUBROUTINE eqn_state_seawater_ij( i, j )
138
139       USE arrays_3d
140       USE indices
141
142       IMPLICIT NONE
143
144       INTEGER ::  i, j, k
145
146       REAL ::  pden, pnom, p1, p2, p3, pt1, pt2, pt3, pt4, sa1, sa15, sa2
147
148       DO  k = nzb_s_inner(j,i)+1, nzt
149!
150!--       Pressure is needed in dbar
151          p1 = hyp(k) * 1E-4
152          p2 = p1 * p1
153          p3 = p2 * p1
154
155!
156!--       Temperature needed in degree Celsius
157          pt1 = pt_p(k,j,i) - 273.15
158          pt2 = pt1 * pt1
159          pt3 = pt1 * pt2
160          pt4 = pt2 * pt2
161
162          sa1  = sa_p(k,j,i)
163          sa15 = sa1 * SQRT( sa1 )
164          sa2  = sa1 * sa1
165
166          pnom = nom(1)           + nom(2)*pt1     + nom(3)*pt2     + &
167                 nom(4)*pt3       + nom(5)*sa1     + nom(6)*sa1*pt1 + &
168                 nom(7)*sa2
169
170          pden = den(1)           + den(2)*pt1     + den(3)*pt2     + &
171                 den(4)*pt3       + den(5)*pt4     + den(6)*sa1     + &
172                 den(7)*sa1*pt1   + den(8)*sa1*pt3 + den(9)*sa15    + &
173                 den(10)*sa15*pt2
174
175!
176!--       Potential density (without pressure terms)
177          prho(k,j,i) = pnom / pden
178
179          pnom = pnom +             nom(8)*p1      + nom(9)*p1*pt2  + &
180                 nom(10)*p1*sa1   + nom(11)*p2     + nom(12)*p2*pt2
181          pden = pden +             den(11)*p1     + den(12)*p2*pt3 + &
182                 den(13)*p3*pt1
183
184!
185!--       In-situ density
186          rho(k,j,i) = pnom / pden
187
188
189       ENDDO
190
191!
192!--    Neumann conditions are assumed at bottom and top boundary
193       prho(nzt+1,j,i)            = prho(nzt,j,i)
194       prho(nzb_s_inner(j,i),j,i) = prho(nzb_s_inner(j,i)+1,j,i)
195       rho(nzt+1,j,i)             = rho(nzt,j,i)
196       rho(nzb_s_inner(j,i),j,i)  = rho(nzb_s_inner(j,i)+1,j,i)
197
198    END SUBROUTINE eqn_state_seawater_ij
199
200
201!------------------------------------------------------------------------------!
202! Equation of state as a function
203!------------------------------------------------------------------------------!
204    REAL FUNCTION eqn_state_seawater_func( p, pt, sa )
205
206       IMPLICIT NONE
207
208       REAL ::  p, p1, p2, p3, pt, pt1, pt2, pt3, pt4, sa, sa15, sa2
209
210!
211!--    Pressure is needed in dbar
212       p1 = p  * 1E-4
213       p2 = p1 * p1
214       p3 = p2 * p1
215
216!
217!--    Temperature needed in degree Celsius
218       pt1 = pt - 273.15
219       pt2 = pt1 * pt1
220       pt3 = pt1 * pt2
221       pt4 = pt2 * pt2
222
223       sa15 = sa * SQRT( sa )
224       sa2  = sa * sa
225
226
227       eqn_state_seawater_func =                                               &
228         ( nom(1)        + nom(2)*pt1       + nom(3)*pt2    + nom(4)*pt3     + &
229           nom(5)*sa     + nom(6)*sa*pt1    + nom(7)*sa2    + nom(8)*p1      + &
230           nom(9)*p1*pt2 + nom(10)*p1*sa    + nom(11)*p2    + nom(12)*p2*pt2   &
231         ) /                                                                   &
232         ( den(1)        + den(2)*pt1       + den(3)*pt2    + den(4)*pt3     + &
233           den(5)*pt4    + den(6)*sa        + den(7)*sa*pt1 + den(8)*sa*pt3  + &
234           den(9)*sa15   + den(10)*sa15*pt2 + den(11)*p1    + den(12)*p2*pt3 + &
235           den(13)*p3*pt1                                                      &
236         )
237
238
239    END FUNCTION eqn_state_seawater_func
240
241 END MODULE eqn_state_seawater_mod
Note: See TracBrowser for help on using the repository browser.