1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
|
! Copyright (C) 2006 Imperial College London and others.
!
! Please see the AUTHORS file in the main source directory for a full list
! of copyright holders.
!
! Prof. C Pain
! Applied Modelling and Computation Group
! Department of Earth Science and Engineering
! Imperial College London
!
! amcgsoftware@imperial.ac.uk
!
! This library is free software; you can redistribute it and/or
! modify it under the terms of the GNU Lesser General Public
! License as published by the Free Software Foundation,
! version 2.1 of the License.
!
! This library is distributed in the hope that it will be useful,
! but WITHOUT ANY WARRANTY; without even the implied warranty of
! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
! Lesser General Public License for more details.
!
! You should have received a copy of the GNU Lesser General Public
! License along with this library; if not, write to the Free Software
! Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
! USA
#include "fdebug.h"
module tidal_diagnostics
use diagnostic_source_fields
use field_options
use fields_manipulation
use initialise_fields_module
use fields
use fldebug
use global_parameters, only : timestep, OPTION_PATH_LEN
use spud
use state_fields_module
use state_module
use Tidal_module
implicit none
private
public :: calculate_free_surface_history, calculate_tidal_harmonics
type harmonic_field
type(scalar_field) , pointer :: s_field
character(len=OPTION_PATH_LEN) :: name ! name of scalar field
integer :: sigmaIndex ! 0 == constant consituent C0, -1 == Residual
character(len=OPTION_PATH_LEN) :: target ! 'Amplitude' or 'Phase'
end type harmonic_field
contains
subroutine calculate_free_surface_history(state, s_field)
!
type(state_type), intent(in) :: state
type(scalar_field), intent(inout) :: s_field
type(scalar_field), pointer :: hist_fs_field
type(scalar_field), pointer :: fs_field
character(len=OPTION_PATH_LEN) :: base_path
integer :: stride, new_snapshot_index, levels, stat, timestep_counter
real :: spin_up_time, current_time, timestep
real, dimension(:), allocatable :: saved_snapshots_times
!
ewrite(3,*),'in free_surface_history_diagnostics'
!
fs_field => extract_scalar_field(state,"FreeSurface",stat)
!
if(stat /= 0) then
FLExit('I do not have a FreeSurface field so can not calculate diagnostics on it. Please switch on the FreeSurface diagnostic.')
return
end if
! get history options
spin_up_time=0
call get_option("/timestepping/current_time", current_time)
call get_option("/timestepping/timestep", timestep)
if(current_time+timestep<spin_up_time) then
ewrite(4,*), "Still spinning up."
return
endif
base_path=trim(complete_field_path(s_field%option_path)) // "/algorithm/"
! levels: the number of levels which will be saved. Too old levels will be overwritten by new ones.
if (have_option(trim(base_path) // "levels")) then
call get_option(trim(base_path) // "levels", levels)
levels=max(levels,0)
else
levels=50
end if
call set_option(trim(base_path) // "levels", levels, stat)
assert(any(stat == (/SPUD_NO_ERROR, SPUD_NEW_KEY_WARNING/)))
! The internal timestep counter of calculate_free_surface_history.
if (have_option(trim(base_path) // "timestep_counter")) then
call get_option(trim(base_path) // "timestep_counter", timestep_counter)
timestep_counter=timestep_counter+1
else
timestep_counter=0
end if
! Lets save the current timestep_counter in the option tree.
call set_option(trim(base_path) // "timestep_counter", timestep_counter,stat)
assert(any(stat == (/SPUD_NO_ERROR, SPUD_NEW_KEY_WARNING/)))
! stride: Defines how many timesteps shall be skipped between two history snapshots.
if (have_option(trim(base_path) // "stride")) then
call get_option(trim(base_path) // "stride", stride)
else
stride=5
end if
call set_option(trim(base_path) // "stride", stride, stat)
assert(any(stat == (/SPUD_NO_ERROR, SPUD_NEW_KEY_WARNING/)))
! check if we want to save the current timestep at all
if (mod(timestep_counter,stride)/=0) then
ewrite(4,*), "Ignoring thbis timestep"
return
end if
allocate(saved_snapshots_times(levels))
if (have_option(trim(base_path) // "saved_snapshots_times")) then
call get_option(trim(base_path) // "saved_snapshots_times", saved_snapshots_times)
end if
! get index where we want to save the new snapshot.
new_snapshot_index=mod(timestep_counter/stride,levels)+1
! Save current free surface field in the history.
! Note: Since diagnositcs are executed after the solving step, we actually save the fields at current_time+timestep
saved_snapshots_times(new_snapshot_index)=current_time+timestep
call set_option(trim(base_path) // "saved_snapshots_times", saved_snapshots_times, stat)
assert(any(stat == (/SPUD_NO_ERROR, SPUD_NEW_KEY_WARNING/)))
ewrite(4,*), 'Filling history level: ', min(timestep_counter/stride+1,levels), '/', levels
!if(.not. s_field%mesh == fs_field%mesh) then
! ewrite(-1, *) "FreeSurface history mesh: " // trim(s_field%mesh%name)
! FLExit("FreeSurface history mesh must be the same as Free Surface mesh")
!end if
! lets copy a snapshot of freesurface to s_field(new_snapshot_index)
hist_fs_field => extract_scalar_field(state,'harmonic'//int2str(new_snapshot_index))
call set(hist_fs_field,fs_field)
deallocate(saved_snapshots_times)
end subroutine calculate_free_surface_history
subroutine calculate_tidal_harmonics(state, s_field)
type(state_type), intent(in) :: state
type(scalar_field), intent(in) :: s_field ! Will not be used!
type(harmonic_field), save, dimension(100) :: harmonic_fields ! Dimension could be automatically determined but 100 harmonic constiuent fields should be enough.
real, dimension(50), save :: sigma ! Dimension could be automatically determined but 50 frequencies should be enough.
integer, save :: last_update=-1, nohfs=-1, M=-1
logical :: ignoretimestep
real, dimension(:), allocatable :: saved_snapshots_times
integer :: i, current_snapshot_index
! Only if Harmonics weren't already calculated in this timestep
if (last_update/=timestep) then
ewrite(3,*), "In tidal_harmonics"
last_update=timestep
call getFreeSurfaceHistoryData(state, ignoretimestep, saved_snapshots_times, current_snapshot_index)
if (.not. ignoretimestep) then
! Initialize the harmonic fields and frequencies if not already done.
if (nohfs==-1) then
call getHarmonicFields(state, harmonic_fields, nohfs, sigma, M)
end if
ewrite(4,*), 'Frequencies to analyse:'
do i=1,M
ewrite(4,*), sigma(i)
end do
! Calculate harmonics and update (all!) harmonic fields
call update_harmonic_fields(state, saved_snapshots_times, size(saved_snapshots_times), current_snapshot_index, sigma, M, harmonic_fields, nohfs)
end if
end if
if (allocated(saved_snapshots_times)) then
deallocate(saved_snapshots_times)
end if
end subroutine calculate_tidal_harmonics
subroutine getFreeSurfaceHistoryData(state, ignoretimestep, saved_snapshots_times, current_snapshot_index)
type(state_type), intent(in) :: state
real, dimension(:), allocatable, intent(out) :: saved_snapshots_times
logical, intent(out) :: ignoretimestep
integer, intent(out) :: current_snapshot_index
character(len = OPTION_PATH_LEN) :: free_surface_history_path
integer :: timestep_counter, stride, levels
type(scalar_field), pointer :: fshistory_sfield
ignoretimestep=.false.
! Find free_surface_history diagonstic field
fshistory_sfield => extract_scalar_field(state, 'FreeSurfaceHistory')
free_surface_history_path = trim(complete_field_path(fshistory_sfield%option_path)) // '/algorithm/'
! get information from free_surface_history diagnostic and check if the harmonic analysis needs to be calculated at this timestep
! These options should be available here, because we ran calculate_free_surface_history() as a dependency before
call get_option(trim(free_surface_history_path) // "timestep_counter", timestep_counter)
call get_option(trim(free_surface_history_path) // "stride", stride)
call get_option(trim(free_surface_history_path) // "levels", levels)
if( mod(timestep_counter,stride)/=0) then
ewrite(4,*),'Do nothing in this timestep.'
ignoretimestep=.true.
return
end if
if(timestep_counter/stride+1 .lt. levels) then
ewrite(4,*), 'Do nothing until levels are filled up.'
ignoretimestep=.true.
return
end if
allocate(saved_snapshots_times(levels))
call get_option(trim(free_surface_history_path) // "saved_snapshots_times", saved_snapshots_times)
current_snapshot_index=mod(timestep_counter/stride,levels)+1
end subroutine getFreeSurfaceHistoryData
subroutine getHarmonicFields(state, harmonic_fields, nohfs, sigma, M)
type(state_type), intent(in) :: state
type(harmonic_field), dimension(:), intent(inout) :: harmonic_fields
real, dimension(:), intent(inout) :: sigma
integer, intent(inout) :: nohfs, M
character(len = OPTION_PATH_LEN) :: lalgorithm, base_path, constituent_name, target
integer :: i, ii
real :: freq
type(scalar_field), pointer :: iter_field
nohfs=0 ! size of harmonic_fields array
M=0 ! size of sigma array
! Get desired constituents from the optione tree
s_field_loop: do ii=1,scalar_field_count(state)
iter_field => extract_scalar_field(state,ii)
if (trim(iter_field%option_path)=='')then
cycle
end if
base_path = trim(complete_field_path(iter_field%option_path)) // '/algorithm/'
if (have_option(trim(base_path) // 'name')) then
call get_option(trim(base_path) // 'name', lalgorithm, default = "Internal")
if (trim(lalgorithm)=='tidal_harmonics') then
nohfs=nohfs+1
if (nohfs>size(harmonic_fields)) then
FLExit('You reached the maximal number (100) of harmonic constituents.')
end if
call get_option(trim(base_path) // 'constituent/name', constituent_name)
harmonic_fields(nohfs)%s_field=>iter_field
harmonic_fields(nohfs)%name=constituent_name
if (trim(constituent_name)=='C0') then
harmonic_fields(nohfs)%sigmaIndex=0
harmonic_fields(nohfs)%target=''
elseif (trim(constituent_name)=='Residual') then
harmonic_fields(nohfs)%sigmaIndex=-1
harmonic_fields(nohfs)%target=''
! Includes prescribed and custom frequencies:
else
call get_option(trim(base_path) // 'target', target)
harmonic_fields(nohfs)%target=target
! Check if we have this constituent frequency already in sigma and if not, save it
call get_option(trim(base_path) // '/constituent', freq)
do i=1,M
if (abs(sigma(i)-freq) <= 1.0E-14) then
harmonic_fields(nohfs)%sigmaIndex=i
cycle s_field_loop
end if
end do
! Frequency was not found, so lets add it to sigma
M=M+1
if (M>size(sigma)) then
FLExit('You reached the maximal number (50) of harmonic frequencies.')
end if
sigma(M) = freq
harmonic_fields(nohfs)%sigmaIndex=M
end if
end if
end if
end do s_field_loop
ewrite(4,*), 'Found ', nohfs, ' constituents to analyse.'
ewrite(4,*), 'Found ', M, ' frequencies to analyse.'
if ( M .le. 0 ) then
FLExit("Internal error in calculate_tidal_harmonics(). No harmonic constituents were found in option tree.")
end if
! check which constituent we want to calculate
! call update_harmonic_analysis(state, levels, current_snapshot_index, saved_snapshots_times, sigma, M, s_field, myconstituent_id, target)
end subroutine getHarmonicFields
subroutine update_harmonic_fields(state, snapshots_times, N, current_snapshot_index, sigma, M, harmonic_fields, nohfs)
type(state_type), intent(in) :: state
integer, intent(in) :: nohfs, M, N, current_snapshot_index ! M = size(sigma), N = size(snapshots_times)
type(harmonic_field), dimension(:), intent(in) :: harmonic_fields
real, dimension(:), intent(in) :: sigma, snapshots_times
real, dimension(:,:), allocatable :: harmonic_A ! for solving Ax=b system
real, dimension(:), allocatable :: harmonic_x, harmonic_b, harmonic_time_series_vals_at_node
integer :: i, ii, stat, node, nonodes
logical :: forceC0toZero
real :: residual
type(scalar_field), pointer :: harmonic_current
!
allocate(harmonic_A(2*M+1,2*M+1))
allocate(harmonic_x(2*M+1))
allocate(harmonic_b(2*M+1))
allocate(harmonic_time_series_vals_at_node(N))
! Set this to .True. if you want to force C0 to 0
forceC0toZero = .False.
! Loop over all nodes of the mesh
harmonic_current => extract_scalar_field(state, 'harmonic1', stat)
nonodes=node_count(harmonic_current)
do node = 1,nonodes
!Extract the free surface elevations at the current node
do i = 1,N
harmonic_current => extract_scalar_field(state,'harmonic'//int2str(i),stat)
harmonic_time_series_vals_at_node(i) = node_val(harmonic_current,node)
end do
!Form and invert the least squares system (Unsorted version)
call harmonic_analysis_at_single_node(N,snapshots_times,harmonic_time_series_vals_at_node,M,sigma,&
harmonic_A,harmonic_x,harmonic_b, forceC0toZero)
! Calculate residual
harmonic_current => extract_scalar_field(state,'harmonic'//int2str(current_snapshot_index),stat)
residual=node_val(harmonic_current,node)
residual=residual-harmonic_x(1)
do ii=1,M
residual=residual-harmonic_x(1+ii)*cos(2*3.141592654*sigma(ii)*snapshots_times(current_snapshot_index))
residual=residual-harmonic_x(1+M+ii)*sin(2*3.141592654*sigma(ii)*snapshots_times(current_snapshot_index))
end do
call save_harmonic_x_in_fields(harmonic_x, residual, M, harmonic_fields, nohfs, node)
end do ! node loop
deallocate(harmonic_A)
deallocate(harmonic_x)
deallocate(harmonic_b)
deallocate(harmonic_time_series_vals_at_node)
end subroutine update_harmonic_fields
subroutine save_harmonic_x_in_fields(harmonic_x, residual, M, harmonic_fields, nohfs, node)
real, dimension(:), intent(in) :: harmonic_x
real, intent(in) :: residual
type(harmonic_field), dimension(:), intent(in) :: harmonic_fields
integer, intent(in) :: nohfs, M, node
integer :: i, MM
real :: result
type(scalar_field), pointer :: harmonic_current
! Loop over harmonic diagnostic fields
do i=1,nohfs
harmonic_current=>harmonic_fields(i)%s_field
MM=harmonic_fields(i)%sigmaIndex
! Check if we want the C0 constituent
if (MM==0) then
call set(harmonic_current, node, harmonic_x(1))
! Check if we want the residual
elseif (MM==-1) then
call set(harmonic_current, node, residual)
end if
!stick the amplitude and phase into something that will be output
if (harmonic_fields(i)%target=='Amplitude') then
call set( harmonic_current, node, sqrt( harmonic_x(MM+1)**2 + harmonic_x(MM+1+M)**2 ) )
elseif (harmonic_fields(i)%target=='Phase') then
if (harmonic_x(MM+1+M)==0 .and. harmonic_x(MM+1)==0) then
FLAbort('Error while calculating harmonic analysis phase!')
end if
result = atan2(harmonic_x(MM+1+M),harmonic_x(MM+1))
!*180.0/pi
!if (phase < 0.0) phase = phase + 360.0
call set( harmonic_current, node, result )
end if
end do
end subroutine save_harmonic_x_in_fields
!
!!!!!!!
subroutine harmonic_analysis_at_single_node(N,harmonic_times_reordered,harmonic_time_series_vals_at_node,M,sigma,&
harmonic_A,harmonic_x,harmonic_b, forceC0toZero)
real, intent(in) :: harmonic_times_reordered(:),harmonic_time_series_vals_at_node(:),sigma(:)
real, intent(inout) :: harmonic_A(:,:),harmonic_x(:),harmonic_b(:)
integer, intent(in) :: M,N
logical, optional, intent(in) :: forceC0toZero
real :: C_k, S_k, CC_jk, SS_jk, SC_jk, CS_kj
real :: pi = 3.141592654
integer :: i, j, k, stat
! For the least squares system
harmonic_A(1,1) = N
! Need the C_k and S_k for first row/column
j = 1
do k = 1,M
C_k = 0.0
S_k = 0.0
do i = 1,N
C_k = C_k + cos(2.*pi*sigma(k)*harmonic_times_reordered(i))
S_k = S_k + sin(2.*pi*sigma(k)*harmonic_times_reordered(i))
end do
harmonic_A(1,k+1) = C_k
harmonic_A(1,k+1+M) = S_k
harmonic_A(k+1,1) = C_k
harmonic_A(k+1+M,1) = S_k
end do
! rest of the rows and columns of the matrix
do j = 1,M
do k = 1,M
CC_jk = 0.0
SS_jk = 0.0
SC_jk = 0.0
do i = 1,N
CC_jk = CC_jk + cos(2.*pi*sigma(k)*harmonic_times_reordered(i))*cos(2.*pi*sigma(j)*harmonic_times_reordered(i))
SS_jk = SS_jk + sin(2.*pi*sigma(k)*harmonic_times_reordered(i))*sin(2.*pi*sigma(j)*harmonic_times_reordered(i))
SC_jk = SC_jk + cos(2.*pi*sigma(k)*harmonic_times_reordered(i))*sin(2.*pi*sigma(j)*harmonic_times_reordered(i))
end do
CS_kj = SC_jk
harmonic_A(j+1,k+1) = CC_jk ! top left quadrant
harmonic_A(j+1+M,k+1+M) = SS_jk ! bottom right quadrant
harmonic_A(j+1+M,k+1) = SC_jk ! bottom left quadrant
harmonic_A(k+1,j+1+M) = SC_jk ! top right quadrant (swap order we fill up matrix as CS_kj.eq.SC_jk, CS_kj.ne.SC_kj)
end do
end do
if(present_and_true(forceC0toZero)) then
harmonic_A(1,2:2*M+1)=0.0
harmonic_A(2:2*M+1,1)=0.0
end if
! now the rhs vector
harmonic_b(1:2*M+1) = 0.0
if(.not. present_and_true(forceC0toZero)) then
do i = 1,N
harmonic_b(1) = harmonic_b(1) + harmonic_time_series_vals_at_node(i)
end do
end if
do j = 1,M
do i = 1,N
harmonic_b(j+1) = harmonic_b(j+1) + harmonic_time_series_vals_at_node(i)*cos(2.*pi*sigma(j)*harmonic_times_reordered(i))
harmonic_b(j+1+M) = harmonic_b(j+1+M) + harmonic_time_series_vals_at_node(i)*sin(2.*pi*sigma(j)*harmonic_times_reordered(i))
end do
end do
! solve the system
call solve(harmonic_A, harmonic_b, stat) ! Solve Ax=b, note that b will be overwritten
harmonic_x = harmonic_b
end subroutine harmonic_analysis_at_single_node
end module tidal_diagnostics
|