-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathnamelist_definition.xml
executable file
·7761 lines (6597 loc) · 283 KB
/
namelist_definition.xml
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
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="http://www.cgd.ucar.edu/~cam/namelist/namelist_definition_CAM.xsl"?>
<namelist_definition>
<!-- Each namelist variable is defined in an <entry> element. The
content of the element is the documentation of how the variable is
used. Other aspects of the variable's definition are expressed as
attributes of the <entry> element. Note that it is an XML requirement
that the attribute values are enclosed in quotes. The attributes are:
id
The variable's name. *** N.B. *** The name must be lower case.
The module convert all namelist variable names to lower case
since Fortran is case insensitive.
type
An abbreviation of the fortran declaration for the variable.
Valid declarations are:
char*n
integer
logical
real
Any of these types may be followed by a comma separated list of
integers enclosed in parenthesis to indicate an array.
The current namelist validation code only distinquishes between
string and non-string types.
input_pathname
Only include this attribute to indicate that the variable
contains the pathname of an input dataset that resides in the
CCSM inputdata directory tree. Note that the variables
containing the names of restart files that are used in branch
runs don't reside in the inputdata tree and should not be given
this attribute.
The recognized values are "abs" to indicate that an absolute
pathname is required, or "rel:var_name" to indicate that the
pathname is relative and that the namelist variable "var_name"
contains the absolute root directory.
category
A category assigned for organizing the documentation.
group
The namelist group that the variable is declared in.
valid_values
This is an optional attribute that is mainly useful for variables
that have only a small number of allowed values.
-->
<!-- Nudging Parameters -->
<entry id="Nudge_Model" type="logical" category="nudging"
group="nudging_nl" valid_values="" >
Toggle Model Nudging ON/OFF.
FORCING:
--------
Nudging tendencies are applied as a relaxation force between the current
model state values and target state values derived from the avalilable
analyses. The form of the target values is selected by the 'Nudge_Force_Opt'
option, the timescale of the forcing is determined from the given
'Nudge_TimeScale_Opt', and the nudging strength Alpha=[0.,1.] for each
variable is specified by the 'Nudge_Xcoef' values. Where X={U,V,T,Q,PS}
F_nudge = Alpha*((Target-Model(t_curr))/TimeScale
WINDOWING:
----------
The region of applied nudging can be limited using Horizontal/Vertical
window functions that are constructed using a parameterization of the
Heaviside step function.
The Heaviside window function is the product of separate horizonal and vertical
windows that are controled via 12 parameters:
Nudge_Hwin_lat0: Specify the horizontal center of the window in degrees.
Nudge_Hwin_lon0: The longitude must be in the range [0,360] and the
latitude should be [-90,+90].
Nudge_Hwin_latWidth: Specify the lat and lon widths of the window as positive
Nudge_Hwin_lonWidth: values in degrees.Setting a width to a large value (e.g. 999)
renders the window a constant in that direction.
Nudge_Hwin_latDelta: Controls the sharpness of the window transition with a
Nudge_Hwin_lonDelta: length in degrees. Small non-zero values yeild a step
function while a large value yeilds a smoother transition.
Nudge_Hwin_Invert : A logical flag used to invert the horizontal window function
to get its compliment.(e.g. to nudge outside a given window).
Nudge_Vwin_Lindex: In the vertical, the window is specified in terms of model
Nudge_Vwin_Ldelta: level indcies. The High and Low transition levels should
Nudge_Vwin_Hindex: range from [0,(NLEV+1)]. The transition lengths are also
Nudge_Vwin_Hdelta: specified in terms of model indices. For a window function
constant in the vertical, the Low index should be set to 0,
the High index should be set to (NLEV+1), and the transition
lengths should be set to 0.001
Nudge_Vwin_Invert : A logical flag used to invert the vertical window function
to get its compliment.
Default: FALSE
</entry>
<entry id="Nudge_Path" type="char*256" input_pathname="abs" category="nudging"
group="nudging_nl" valid_values="" >
Full pathname of analyses data to use for nudging.
(e.g. '/$DIN_LOC_ROOT/atm/cam/nudging/')
Default: none
</entry>
<entry id="Nudge_File_Template" type="char*80" category="nudging"
group="nudging_nl" valid_values="" >
Template for Nudging analyses file names.
(e.g. '%y/ERAI_ne30np4_L30.cam2.i.%y-%m-%d-%s.nc')
Default: none
</entry>
<entry id="Nudge_Times_Per_Day" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Number of analyses files per day.
(e.g. 4 --> 6 hourly analyses)
Default: none
</entry>
<entry id="Model_Times_Per_Day" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Number of time to update model data per day.
(e.g. 48 --> 1800 Second timestep)
Default: none
</entry>
<entry id="Nudge_Beg_Year" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Year at which Nudging Begins.
Default: none
</entry>
<entry id="Nudge_Beg_Month" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Month at which Nudging Begins.
Default: none
</entry>
<entry id="Nudge_Beg_Day" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Day at which Nudging Begins.
Default: none
</entry>
<entry id="Nudge_End_Year" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Year at which Nudging Ends.
Default: none
</entry>
<entry id="Nudge_End_Month" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Month at which Nudging Ends.
Default: none
</entry>
<entry id="Nudge_End_Day" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Day at which Nudging Ends.
Default: none
</entry>
<entry id="Nudge_Force_Opt" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Select the form of nudging forcing, where (t'==Analysis times ; t==Model Times)
0 -> NEXT-OBS: Target=Anal(t'_next)
1 -> LINEAR: Target=(F*Anal(t'_curr) +(1-F)*Anal(t'_next))
F =(t'_next - t_curr )/Tdlt_Anal
Default: 0
</entry>
<entry id="Nudge_TimeScale_Opt" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Select the timescale of nudging force, where (t'==Analysis times ; t==Model Times)
0 --> TimeScale = 1/Tdlt_Anal
1 --> TimeScale = 1/(t'_next - t_curr )
Default: 0
</entry>
<entry id="Nudge_Uprof" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Profile index for U nudging.
0 == OFF (No Nudging of this variable)
1 == CONSTANT (Spatially Uniform Nudging)
2 == HEAVISIDE WINDOW FUNCTION
Default: 0
</entry>
<entry id="Nudge_Ucoef" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Normalized Coeffcient for U nudging.
[0.,1.] fraction of nudging tendency applied.
Default: 0.
</entry>
<entry id="Nudge_Vprof" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Profile index for V nudging.
0 == OFF (No Nudging of this variable)
1 == CONSTANT (Spatially Uniform Nudging)
2 == HEAVISIDE WINDOW FUNCTION
Default: 0
</entry>
<entry id="Nudge_Vcoef" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Normalized Coeffcient for V nudging.
[0.,1.] fraction of nudging tendency applied.
Default: 0.
</entry>
<entry id="Nudge_Tprof" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Profile index for T nudging.
0 == OFF (No Nudging of this variable)
1 == CONSTANT (Spatially Uniform Nudging)
2 == HEAVISIDE WINDOW FUNCTION
Default: 0
</entry>
<entry id="Nudge_Tcoef" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Normalized Coeffcient for T nudging.
[0.,1.] fraction of nudging tendency applied.
Default: 0.
</entry>
<entry id="Nudge_Qprof" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Profile index for Q nudging.
0 == OFF (No Nudging of this variable)
1 == CONSTANT (Spatially Uniform Nudging)
2 == HEAVISIDE WINDOW FUNCTION
Default: 0
</entry>
<entry id="Nudge_Qcoef" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Normalized Coeffcient for Q nudging.
[0.,1.] fraction of nudging tendency applied.
Default: 0.
</entry>
<entry id="Nudge_PSprof" type="integer" category="nudging"
group="nudging_nl" valid_values="" >
Profile index for PS nudging.
0 == OFF (No Nudging of this variable)
1 == CONSTANT (Spatially Uniform Nudging)
2 == HEAVISIDE WINDOW FUNCTION
Default: 0
</entry>
<entry id="Nudge_PScoef" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Normalized Coeffcient for PS nudging.
[0.,1.] fraction of nudging tendency applied.
Default: 0.
</entry>
<entry id="Nudge_Hwin_lat0" type="real" category="nudging"
group="nudging_nl" valid_values="" >
LAT0 center of Horizontal Window in degrees [-90.,90.].
Default: none
</entry>
<entry id="Nudge_Hwin_latWidth" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Width of LAT Window in degrees.
Default: none
</entry>
<entry id="Nudge_Hwin_latDelta" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Width of transition which controls the steepness of window transition in latitude.
0. --> Step function
Default: none
</entry>
<entry id="Nudge_Hwin_lon0" type="real" category="nudging"
group="nudging_nl" valid_values="" >
LON0 center of Horizontal Window in degrees [0.,360.].
Default: none
</entry>
<entry id="Nudge_Hwin_lonWidth" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Width of LON Window in degrees.
Default: none
</entry>
<entry id="Nudge_Hwin_lonDelta" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Width of transition which controls the steepness of window transition in longitude.
0. --> Step function
Default: none
</entry>
<entry id="Nudge_Hwin_Invert" type="logical" category="nudging"
group="nudging_nl" valid_values="" >
Invert Horizontal Window Function to its Compliment.
TRUE = value=0 inside the specified window, 1 outside
FALSE = value=1 inside the specified window, 0 outside
Default: FALSE
</entry>
<entry id="Nudge_Vwin_Hindex" type="real" category="nudging"
group="nudging_nl" valid_values="" >
HIGH Level Index for Verical Window specified in terms of model level indices.
(e.g. For a 30 level model, Nudge_Vwin_Hindex ~ 30 )
Default: none
</entry>
<entry id="Nudge_Vwin_Hdelta" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Width of transition for HIGH end of Vertical Window.
Default: none
</entry>
<entry id="Nudge_Vwin_Lindex" type="real" category="nudging"
group="nudging_nl" valid_values="" >
LOW Level Index for Verical Window specified in terms of model level indices.
(e.g. Nudge_Vwin_Lindex ~ 0 )
Default: none
</entry>
<entry id="Nudge_Vwin_Ldelta" type="real" category="nudging"
group="nudging_nl" valid_values="" >
Width of transition for LOW end of Vertical Window.
Default: none
</entry>
<entry id="Nudge_Vwin_Invert" type="logical" category="nudging"
group="nudging_nl" valid_values="" >
Invert Vertical Window Function to its Compliment.
TRUE = value=0 inside the specified window, 1 outside
FALSE = value=1 inside the specified window, 0 outside
Default: FALSE
</entry>
<!-- Aerosols: Data (CAM version) -->
<entry id="bndtvaer" type="char*256" input_pathname="abs" category="aero_data_cam"
group="cam3_aero_data_nl" valid_values="" >
Full pathname of time-variant boundary dataset for aerosol masses.
Default: set by build-namelist.
</entry>
<entry id="cam3_aero_data_on" type="logical" category="aero_data_cam"
group="cam3_aero_data_nl" valid_values="" >
Add CAM3 prescribed aerosols to the physics buffer.
Default: FALSE
</entry>
<!-- Coupler between Physics and Dynamics -->
<entry id="phys_alltoall" type="integer" category="perf_dp_coup"
group="phys_grid_nl" valid_values="0,1,2,11,12,13">
Dynamics/physics transpose method for nonlocal load-balance.
0: use mpi_alltoallv.
1: use point-to-point MPI-1 two-sided implementation.
2: use point-to-point MPI-2 one-sided implementation if supported, otherwise use
MPI-1 implementation.
3: use Co-Array Fortran implementation if supported, otherwise use MPI-1 implementation.
11-13: use mod_comm, choosing any of several methods internal to mod_comm. The method
within mod_comm (denoted mod_method) has possible values 0,1,2 and is set according
to mod_method = phys_alltoall - modmin_alltoall, where modmin_alltoall is 11.
-1: use option 1 when each process communicates with less than half of the other
processes, otherwise use option 0 (if max_nproc_smpx and nproc_busy_d are both > npes/2).
Default: -1
</entry>
<entry id="phys_chnk_per_thd" type="integer" category="perf_dp_coup"
group="phys_grid_nl" valid_values="">
Select target number of chunks per thread. Must be positive.
Default: 1
</entry>
<entry id="phys_loadbalance" type="integer" category="perf_dp_coup"
group="phys_grid_nl" valid_values="">
Physics grid decomposition options.
-1: each chunk is a dynamics block.
0: chunk definitions and assignments do not require interprocess comm.
1: chunk definitions and assignments do not require internode comm.
2: optimal diurnal, seasonal, and latitude load-balanced chunk definition and assignments.
3: chunk definitions and assignments only require communication with one other process.
4: concatenated blocks, no load balancing, no interprocess communication.
Default: 2
</entry>
<entry id="phys_twin_algorithm" type="integer" category="perf_dp_coup"
group="phys_grid_nl" valid_values="">
Physics grid decomposition options.
0: assign columns to chunks as single columns, wrap mapped across chunks
1: use (day/night; north/south) twin algorithm to determine load-balanced pairs of
columns and assign columns to chunks in pairs, wrap mapped
Default: 0 for unstructured grid dycores, 1 for lat/lon grid dycores
</entry>
<!-- Diagnostics -->
<entry id="diag_cnst_conv_tend" type="char*8" category="diagnostics"
group="cam_diag_opts" valid_values="none,q_only,all" >
Output constituent tendencies due to convection. Set to
'none', 'q_only' or 'all'.
Default: 'q_only'
</entry>
<entry id="do_circulation_diags" type="logical" category="diagnostics"
group="circ_diag_nl" valid_values="" >
Turns on TEM circulation diagnostics history output. Only valid for FV dycore.
Default: .false., unless it is overridden (WACCM with interactive chemistry and a few other specific
configurations do this)
</entry>
<entry id="print_energy_errors" type="logical" category="diagnostics"
group="check_energy_nl" valid_values="" >
Turn on verbose output identifying columns that fail energy/water
conservation checks.
Default: FALSE
</entry>
<entry id="print_qneg_warn" type="char*8" category="diagnostics"
group="qneg_nl" valid_values="summary,timestep,off" >
Control the writing of qneg3 and qneg4 warning messages.
'summary' causes a summary of QNEG3 and QNEG4 errors to be
printed at the end of the run
'timestep' causes a summary of QNEG3 and QNEG4 errors to be printed at the
end of each timestep. The total is reset at the end of each timestep.
'off' causes the qneg3 and qneg4 warnings to be supressed.
Note that these settings do not affect the availability of qneg
history variables.
Default: 'summary'
</entry>
<!-- Dry Convective Adjustment -->
<entry id="dadadj_nlvdry" type="integer" category="dry_conv_adj"
group="dadadj_nl" valid_values="" >
Number of layers from the top of the model over which to do dry convective
adjustment. Must be less than plev (the number of vertical levels).
Default: 3
</entry>
<entry id="dadadj_niter" type="integer" category="dry_conv_adj"
group="dadadj_nl" valid_values="" >
The maximum number of iterations to achieve convergence in dry adiabatic adjustment.
For WACCM-X it can be advantageous to use a number which is much higher than the CAM
default.
Default: 15
</entry>
<!-- Dynamics: Finite Volume -->
<entry id="fv_nsplit" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Number of dynamics timesteps per physics timestep. If zero, a best-estimate
will be automatically calculated.
Default: 0
</entry>
<entry id="fv_nspltrac" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Number of tracer advection timesteps per physics timestep.
Nsplit is partitioned into nspltrac and nsplit/nspltrac,
with the latter being the number of dynamics timesteps per
tracer timestep, possibly rounded upward; after initialization,
the code quantity nsplit is redefined to be the number of
dynamics timesteps per tracer timestep.
Default: 0
</entry>
<entry id="fv_nspltvrm" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Number of vertical re-mapping timesteps per physics timestep.
Nspltrac is partitioned into nspltvrm and nspltrac/nspltvrm,
with the latter being the number of tracer timesteps per
re-mapping timestep, possibly rounded upward; after initialization,
the code quantity nspltrac is redefined to be the number of
tracer timesteps per re-mapping timestep.
Default: 0
</entry>
<entry id="fv_iord" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Order (mode) of X interpolation (1,..,6).
East-West transport scheme.
= 1: first order upwind
= 2: 2nd order van Leer (Lin et al 1994)
= 3: standard PPM
= 4: enhanced PPM (default)
Default: 4
</entry>
<entry id="fv_jord" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Order (mode) of Y interpolation (1,..,6).
North-South transport scheme.
= 1: first order upwind
= 2: 2nd order van Leer (Lin et al 1994)
= 3: standard PPM
= 4: enhanced PPM (default)
Default: 4
</entry>
<entry id="fv_kord" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Scheme to be used for vertical mapping.
= 1: first order upwind
= 2: 2nd order van Leer (Lin et al 1994)
= 3: standard PPM
= 4: enhanced PPM (default)
Default: 4
</entry>
<entry id="fv_conserve" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Flag indicating whether the dynamics uses internal algorithm for energy
conservation.
Default: .false.
</entry>
<entry id="fv_filtcw" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="0,1" >
Enables optional filter for intermediate c-grid winds, (courtesy of Bill Putman).
Default: 0
</entry>
<entry id="fv_fft_flt" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="0,1" >
1 for FFT filter always, 0 for combined algebraic/FFT filter. The value 0
is used for CAM3, otherwise it is using the value 1.
Default: set by build-namelist
</entry>
<entry id="fv_div24del2flag" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="2,4,42" >
Chooses type of divergence damping and velocity diffusion.
div24del2flag = 2 for ldiv2 (default),
= 4 for ldiv4,
= 42 for ldiv4 + ldel2
where
ldiv2: 2nd-order divergence damping everywhere and increasing in top layers
ldiv4: 4th-order divergence damping
ldel2: 2nd-order velocity-component damping targetted to top layers,
with coefficient del2coef
Default: set by build-namelist
</entry>
<entry id="fv_del2coef" type="real" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Chooses level of velocity diffusion.
Default: 3.0e5
</entry>
<entry id="fv_high_order_top" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Flag to extend standard 4th-order PPM scheme to model top.
Default: .false.
</entry>
<entry id="fv_am_geom_crrct" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Flag to turn on corrections in FV geometry and/or pressure terms.
Default: .false.
</entry>
<entry id="fv_am_correction" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Flag to turn on corrections that improve angular momentum conservation.
Default: .false.
</entry>
<entry id="fv_am_fixer" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Flag to apply an arbitrary fix based on solid-body rotation to the zonal
velocity fields to improve conservation of angular momentum.
Default: .false.
</entry>
<entry id="fv_am_fix_lbl" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Flag to apply the fixer turned on by fv_am_fixer level by level. The
intent is to not contaminate the stratospheric circulation with
tropospheric AM loss, where it is most likely greatest (due to the larger
divergence fields). This option is experimental.
Default: .false.
</entry>
<entry id="fv_am_diag" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Flag to turn on a diagnostic calculation of angular momentum which is
written to the log file at each time step. Also enables calculation of
fields written to history file which are used in conjuction with those
enabled by do_circulation_diags for detailed analysis.
Default: .false.
</entry>
<entry id="fv_high_altitude" type="logical" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Switch to apply variable physics appropriate for the thermosphere and ionosphere
Default: set by build-namelist
</entry>
<entry id="fv_print_dpcoup_warn" type="char*8" category="dyn_fv"
group="dyn_fv_inparm" valid_values="off,full" >
Flag to determine how to handle dpcoup warning messages
Default: off
</entry>
<!-- MPI configuration for FV dycore -->
<entry id="force_2d" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Set to 1 to force the 2D transpose computation when a 1D decomposition is
used. This is intended for debugging purposes only.
Default: 0
</entry>
<entry id="geopktrans" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1,2" >
Geopotential method (routines geopk, geopk16, or geopk_d).
=0 for transpose method;
=1 for method using semi-global z communication with optional 16-byte arithmetic;
=2 for method using local z communication;
method 0, method 1 with 16-byte arithmetic and method 2 are all bit-for-bit across decompositions;
method 0 scales better than method 1 with npr_z, and method 1 is superior to method 0 for small npr_z;
The optimum speed is attained using either method 1 with 8-byte
arithmetic (standard for geopk16) or method 2 when utilizing the
optimal value for the associated parameter geopkblocks; for the last
two subcycles of a timestep, method 0 is automatically used; see
geopk.F90 and cd_core.F90.
Default: 0
</entry>
<entry id="geopkblocks" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Geopotential method 2 pipeline parameter (routine geopk_d).
geopk_d implements a pipeline algorithm by dividing the
information that must be moved between processes into blocks. geopkblocks
specifies the number of blocks to use. The larger the number of blocks,
the greater the opportunity for overlapping communication with computation
and for decreasing instantaneous bandwidth requirements. The smaller the
number of blocks, the fewer MPI messages sent, decreasing MPI total latency.
See geopk_d within geopk.F90.
Default: 1
</entry>
<entry id="modc_sw_dynrun" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1,2" >
Mod_comm irregular underlying communication method for dyn_run/misc.
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 0
</entry>
<entry id="modc_hs_dynrun" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for dyn_run/misc
Default: .true.
</entry>
<entry id="modc_send_dynrun" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for dyn_run/misc,
false for nonblocking send
Default: .true.
</entry>
<entry id="modc_mxreq_dynrun" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for dyn_run/misc.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>
<entry id="modc_sw_cdcore" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1,2" >
Mod_comm irregular underlying communication method for cd_core/geopk
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 0
</entry>
<entry id="modc_hs_cdcore" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for cd_core/geopk
Default: .true.
</entry>
<entry id="modc_send_cdcore" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for geopk_d and mod_comm irregular communication blocking send for
cd_core/geopk; false for nonblocking send.
Default: .true.
</entry>
<entry id="modc_mxreq_cdcore" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for cd_core/geopk.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>
<entry id="modc_sw_gather" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1,2" >
Mod_comm irregular underlying communication method for gather
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 1
</entry>
<entry id="modc_hs_gather" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for gather
Default: .true.
</entry>
<entry id="modc_send_gather" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for gather,
false for nonblocking send
Default: .true.
</entry>
<entry id="modc_mxreq_gather" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for gather.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: 64
</entry>
<entry id="modc_sw_scatter" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1,2" >
Mod_comm irregular underlying communication method for scatter
0 for original mp_sendirr/mp_recvirr
1 for mp_swapirr and a point-to-point implementation of communication pattern
2 for mp_swapirr and a collective (MPI_Alltoallv) implementation of communication pattern
Default: 0
</entry>
<entry id="modc_hs_scatter" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication handshaking for scatter
Default: .false.
</entry>
<entry id="modc_send_scatter" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for scatter,
false for nonblocking send
Default: .true.
</entry>
<entry id="modc_mxreq_scatter" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swapirr and point-to-point communications for scatter.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>
<entry id="modc_sw_tracer" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Mod_comm irregular underlying communication method for multiple tracers
0 for original mp_sendtrirr/mp_recvtrirr
1 for mp_swaptrirr and point-to-point communications
2 for mp_swaptrirr and all-to-all communications
Default: 0
</entry>
<entry id="modc_hs_tracer" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1,2" >
True for mod_comm irregular communication handshaking for multiple tracers
Default: .true.
</entry>
<entry id="modc_send_tracer" type="logical" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
True for mod_comm irregular communication blocking send for multiple
tracers, false for nonblocking send
Default: .true.
</entry>
<entry id="modc_mxreq_tracer" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Maximum number of outstanding nonblocking MPI requests to allow when
using mp_swaptrirr and point-to-point communications for multiple tracers.
Setting this less than the maximum can improve robustness for large process
count runs. If set to less than zero, then do not limit the number of
outstanding send/receive requests.
Default: -1 (so no limit)
</entry>
<entry id="modc_onetwo" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="1,2" >
One or two simultaneous mod_comm irregular communications (excl. tracers)
Default: 2
</entry>
<entry id="modc_tracers" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Max number of tracers for simultaneous mod_comm irregular communications
Default: 3
</entry>
<entry id="modcomm_gatscat" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1" >
For mod_comm gather/scatters, 0 for temporary contiguous buffers; 1 for mpi derived
types.
Default: 0
</entry>
<entry id="modcomm_geopk" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1" >
For geopk (geopktrans=1) messages, 0 for temporary contiguous buffers; 1 for mpi derived
types.
Default: 0
</entry>
<entry id="modcomm_transpose" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="0,1" >
For mod_comm transposes, 0 for temporary contiguous buffers; 1 for mpi derived
types.
Default: 0
</entry>
<entry id="npr_yz" type="integer(4)" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
A four element integer array which specifies the YZ and XY decompositions.
The first two elements are the number of Y subdomains and number of Z
subdomains in the YZ decomposition. The second two elements are the number
of X subdomains and the number of Y subdomains in the XY decomposition.
Note that both the X and Y subdomains must contain at least 3 grid points.
For example, a grid with 96 latitudes can contain no more than 32 Y
subdomains. There is no restriction on the number of grid points (levels)
in a Z subdomain, but note that the threading parallelism in the FV dycore
is over levels, so for parallel efficiency it is best to have at least the
number of levels in each Z subdomain as there are threads available.
There are a couple of rough rules of thumb to follow when setting the 2D
decompositions. The first is that the number of Y subdomains in the YZ
decomposition should be the same as the number of Y subdomains in the XY
decomposition (npr_yz(1) == npr_yz(4)). The second is that the total
number of YZ subdomains (npr_yz(1)*npr_yz(2)) should equal the total number
of XY subdomains (npr_yz(3)*npr_yz(4)).
Default: ntask,1,1,ntask where ntask is the number of MPI tasks. This is a
1D decomposition in latitude.
</entry>
<entry id="fv_ct_overlap" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Overlapping of trac2d and cd_core subcycles.
Default: 0
</entry>
<entry id="fv_trac_decomp" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
Size of tracer domain decomposition for trac2d.
Default: 1
</entry>
<entry id="print_filew_warn" type="char*8" category="dyn_fv"
group="fill_nl" valid_values="off,full" >
Control the writing of filew warning messages.
Default: 'off'
</entry>
<!-- Dynamics: Finite Volume: Offline -->
<entry id="met_cell_wall_winds" type="logical" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
TRUE => the offline meteorology winds are defined on the model grid cell walls.
Default: FALSE
</entry>
<entry id="met_data_file" type="char*256" input_pathname="rel:met_data_path" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
Name of file that contains the offline meteorology data.
Default: none
</entry>
<entry id="met_data_path" type="char*256" input_pathname="abs" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
Name of directory that contains the offline meteorology data.
Default: none
</entry>
<entry id="met_filenames_list" type="char*256" input_pathname="abs" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
Name of file that contains names of the offline meteorology data files.
Default: none
</entry>
<entry id="met_remove_file" type="logical" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
TRUE => the offline meteorology file will be removed from local disk when no longer needed.
Default: FALSE
</entry>
<entry id="met_rlx_top" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
(km) top of relaxation region of winds for offline waccm
Default: 60.
</entry>
<entry id="met_rlx_bot" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
(km) bottom of relaxation region of winds for offline waccm
Default: 50.
</entry>
<entry id="met_rlx_bot_top" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
(km) top of ramping relaxation region for metdata at model bottom
Default: 0.
</entry>
<entry id="met_rlx_bot_bot" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
(km) bottom of ramping relaxation region for metdata at model bottom
Default: 0.
</entry>
<entry id="met_rlx_time" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
Relaxation time (hours) applied to specified meteorology.
- positive values less then time step size gives 100% nudging
- negative values gives 0.0% nudging (infinite relaxation time)
Default: 0.0
</entry>
<entry id="met_fix_mass" type="logical" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
switch to turn on/off mass fixer for offline driver
Default: true
</entry>
<entry id="met_shflx_name" type="char*16" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
srf heat flux field name in met data file
Default: 'SHFLX'
</entry>
<entry id="met_qflx_name" type="char*16" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
water vapor flux field name in met data file
Default: 'QFLX'
</entry>
<entry id="met_shflx_factor" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
multiplication factor for srf heat flux
Default: 1.0
</entry>
<entry id="met_qflx_factor" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
multiplication factor for water vapor flux
Default: 1.0
</entry>
<entry id="met_snowh_factor" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
multiplication factor for snow hieght
Default: 1.0
</entry>
<entry id="met_srf_feedback" type="logical" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
If false then do not allow surface models feedbacks influence climate
Default: true
</entry>