-
Notifications
You must be signed in to change notification settings - Fork 1
/
namelist_definition.xml
5532 lines (4688 loc) · 197 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.
-->
<!-- 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="cam_inparm" 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 (approx.).
Default: -1
</entry>
<entry id="phys_chnk_per_thd" type="integer" category="perf_dp_coup"
group="cam_inparm" 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="cam_inparm" 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: 0
</entry>
<entry id="phys_twin_algorithm" type="integer" category="perf_dp_coup"
group="cam_inparm" 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="history_amwg" type="logical" category="diagnostics"
group="phys_ctl_nl" valid_values="" >
Switch for diagnostic output of AMWG diag package variables
Default: .true.
</entry>
<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', but 'none' for WACCM configurations.
</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: .true. for WACCM with interactive chemistry, otherwise .false.
</entry>
<entry id="print_energy_errors" type="logical" category="diagnostics"
group="cam_inparm" valid_values="" >
Turn on verbose output identifying columns that fail energy/water
conservation checks.
Default: FALSE
</entry>
<!-- Dry Convective Adjustment -->
<entry id="nlvdry" type="integer" category="dry_conv_adj"
group="cam_inparm" 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>
<!-- Dynamics: Finite Volume -->
<entry id="ct_overlap" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Overlapping of trac2d and cd_core subcycles.
Default: 0
</entry>
<entry id="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. In the CAM3
version of the model it was necessary to build with the CPP
variable ALT_PFT defined to get the behavior now obtained by setting fft_flt=1.
Default: set by build-namelist
</entry>
<entry id="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="del2coef" type="real" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Chooses level of velocity diffusion.
Default: 3.0e5
</entry>
<entry id="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="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="" >
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="" >
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="" >
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: 0
</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: -1 (so no limit)
</entry>
<entry id="modc_sw_scatter" type="integer" category="dyn_fv"
group="spmd_fv_inparm" valid_values="" >
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: .true.
</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="" >
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="" >
One or two simultaneous mod_comm irregular communications (excl. tracers)
Default: 1
</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: 1
</entry>
<entry id="iord" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Order (mode) of X interpolation (1,..,6).
East-West transport scheme (used with Finite Volume dynamical core only).
Default: 4
</entry>
<entry id="jord" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Order (mode) of Y interpolation (1,..,6).
North-South transport scheme (used with Finite Volume dynamical core only).
Default: 4
</entry>
<entry id="kord" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Scheme to be used for vertical mapping.
Default: 4
</entry>
<entry id="modcomm_gatscat" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="0,1,2" >
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="dyn_fv_inparm" valid_values="0,1,2" >
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="dyn_fv_inparm" valid_values="0,1,2" >
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="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="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="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="trac_decomp" type="integer" category="dyn_fv"
group="dyn_fv_inparm" valid_values="" >
Size of tracer domain decomposition for trac2d.
Default: 1
</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:
</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:
</entry>
<entry id="met_max_rlx" type="real" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
maximum of vertical relaxation function in bottom portion
Default: 1.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:
</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:
</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>
<entry id="met_srf_nudge_flux" type="logical" category="dyn_fv_off"
group="metdata_nl" valid_values="" >
if true nudge meteorology surface fields TAUX, TAUY, SHFLX, QFLX rather than force
Default: true
</entry>
<!-- Dynamics: Spectral -->
<entry id="eul_nsplit" type="integer" category="dyn_spectral"
group="dyn_spectral_inparm" valid_values="" >
Number of dynamics timesteps per physics timestep. If zero, a best-estimate
will be automatically calculated.
Default: 1
</entry>
<entry id="dif2" type="real" category="dyn_spectral"
group="dyn_spectral_inparm" valid_values="" >
del^2 horizontal diffusion coefficient. Default: resolution dependent,
e.g. 2.5e5 for T42 EUL.
</entry>
<entry id="dif4" type="real" category="dyn_spectral"
group="dyn_spectral_inparm" valid_values="">
del^4 horizontal diffusion coefficient. Default: resolution dependent,
e.g. 1.0e16 for T42 EUL.
</entry>
<entry id="divdampn" type="real" category="dyn_spectral"
group="dyn_spectral_inparm" valid_values="">
Number of days (from timestep 0) to run divergence damper. Use only if spectral
model becomes dynamicallly unstable during initialization. Suggested value:
2. (Value must be >= 0.) Default: 0.
</entry>
<entry id="dyn_allgather" type="integer" category="dyn_spectral"
group="spmd_dyn_inparm" valid_values="">
Spectral dynamics gather option.
Default: 0
</entry>
<entry id="dyn_alltoall" type="integer" category="dyn_spectral"
group="spmd_dyn_inparm" valid_values="">
Spectral dynamics transpose option.
Default: 0
</entry>
<entry id="dyn_equi_by_col" type="logical" category="dyn_spectral"
group="spmd_dyn_inparm" valid_values="">
Flag indicating whether to assign latitudes to equidistribute columns or
latitudes. This only matters when using a reduced grid.
Default: TRUE
</entry>
<entry id="dyn_npes" type="integer" category="dyn_spectral"
group="spmd_dyn_inparm" valid_values="">
Number of processes assigned to dynamics (SE, EUL and SLD dycores).
Default: Total number of processes assigned to job.
</entry>
<entry id="dyn_npes_stride" type="integer" category="dyn_spectral"
group="spmd_dyn_inparm" valid_values="">
Stride for dynamics processes (EUL and SLD dycores).
E.g., if stride=2, assign every second process to the dynamics.
Default: 1
</entry>
<entry id="eps" type="real" category="dyn_spectral"
group="dyn_spectral_inparm" valid_values="">
Time filter coefficient. Default: 0.06
</entry>
<entry id="kmxhdc" type="integer" category="dyn_spectral"
group="dyn_spectral_inparm" valid_values="">
Number of levels over which to apply Courant limiter, starting at top of
model.
Default: 5
</entry>
<!-- Gravity Wave Drag -->
<entry id="fcrit2" type="real" category="gw_drag"
group="gw_drag_nl" valid_values="" >
Critical Froude number squared.
Default: set by build-namelist.
</entry>
<!-- Greenhouse Gases: CO2, CH4, N2O, CFC11, CFC12 (original CAM versions) -->
<entry id="bndtvghg" type="char*256" input_pathname="abs" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
Full pathname of time-variant boundary dataset for greenhouse gas surface
values.
Default: set by build-namelist.
</entry>
<entry id="ch4vmr" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
CH4 volume mixing ratio. This is used as the time invariant surface value
of CH4 if no time varying values are specified.
Default: set by build-namelist.
</entry>
<entry id="co2vmr" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
CO2 volume mixing ratio. This is used as the time invariant surface value
of CO2 if no time varying values are specified.
Default: set by build-namelist.
</entry>
<entry id="co2vmr_rad" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
User override for the prescribed CO2 volume mixing ratio used by the radiation
calculation. Note however that the prescribed value of CO2 which is sent
to the surface models is still the one that is set using either the
<varname>co2vmr</varname> or the <varname>scenario_ghg</varname> variables.
Default: not used
</entry>
<entry id="f11vmr" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
CFC11 volume mixing ratio adjusted to reflect contributions from many GHG
species. This is used as the time invariant surface value of F11 if no
time varying values are specified.
Default: set by build-namelist.
</entry>
<entry id="f12vmr" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
CFC12 volume mixing ratio. This is used as the time invariant surface value
of CFC12 if no time varying values are specified.
Default: set by build-namelist.
</entry>
<entry id="n2ovmr" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
N2O volume mixing ratio. This is used as the time invariant surface value
of N2O if no time varying values are specified.
Default: 0.311e-6
</entry>
<entry id="ghg_yearstart_data" type="integer" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
Data start year. Use in conjunction
with <varname>ghg_yearstart_model</varname>.
Default: 0
</entry>
<entry id="ghg_yearstart_model" type="integer" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
Model start year. Use in conjunction
with <varname>ghg_yearstart_data</varname>.
Default: 0
</entry>
<entry id="ramp_co2_annual_rate" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
Amount of co2 ramping per year (percent). Only used
if <varname>scenario_ghg</varname> = 'RAMP_CO2_ONLY'
Default: 1.0
</entry>
<entry id="ramp_co2_cap" type="real" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
CO2 cap if > 0, floor otherwise. Specified as multiple or fraction of
inital value; e.g., setting to 4.0 will cap at 4x initial CO2 setting.
Only used if <varname>scenario_ghg</varname> = 'RAMP_CO2_ONLY'
Default: boundless if <varname>ramp_co2_annual_rate</varname> > 0, zero otherwise.
</entry>
<entry id="ramp_co2_start_ymd" type="integer" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
Date on which ramping of co2 begins. The date is encoded as an integer in
the form YYYYMMDD. Only used if <varname>scenario_ghg</varname> = 'RAMP_CO2_ONLY'
Default: 0
</entry>
<entry id="rampyear_ghg" type="integer" category="ghg_cam"
group="chem_surfvals_nl" valid_values="" >
If <varname>scenario_ghg</varname> is set to "RAMPED" then the greenhouse
gas surface values are interpolated between the annual average values
read from the file specified by <varname>bndtvghg</varname>.
In that case, the value of this variable (> 0) fixes the year of the
lower bounding value (i.e., the value for calendar day 1.0) used in the
interpolation. For example, if rampyear_ghg = 1950, then the GHG surface
values will be the result of interpolating between the values for 1950 and
1951 from the dataset.
Default: 0
</entry>
<entry id="scenario_ghg" type="char*16" category="ghg_cam"
group="chem_surfvals_nl" valid_values="FIXED,RAMPED,RAMP_CO2_ONLY" >
Controls treatment of prescribed co2, ch4, n2o, cfc11, cfc12 volume mixing
ratios. May be set to 'FIXED' or 'RAMPED' or 'RAMP_CO2_ONLY'.
FIXED => volume mixing ratios are fixed and have either default or namelist
input values.
RAMPED => volume mixing ratios are time interpolated from the dataset
specified by <varname>bndtvghg</varname>.
RAMP_CO2_ONLY => only co2 mixing ratios are ramped at a rate determined by
the variables <varname>ramp_co2_annual_rate</varname>, <varname>ramp_co2_cap</varname>,
and <varname>ramp_co2_start_ymd</varname>.
Default: FIXED
</entry>
<!-- Greenhouse Gases: prognostic CH4, N2O, CFC11, CFC12 (original CAM versions) -->
<entry id="bndtvg" type="char*256" input_pathname="abs" category="ghg_chem"
group="chem_inparm" valid_values="" >
Full pathname of time-variant boundary dataset for greenhouse gas production/loss
rates. Only used by the simple prognostic GHG chemistry scheme that is
enabled via the argument "-prog_species GHG" to configure.
Default: set by build-namelist.
</entry>
<entry id="ghg_chem" type="logical" category="ghg_chem"
group="chem_inparm" valid_values="" >
This variable should not be set by the user. It is set by build-namelist
when the user specifies the argument "-prog_species GHG" to configure which
turns on a simple prognostic chemistry scheme for CH4, N2O, CFC11 and
CFC12.
Default: set by build-namelist
</entry>
<!-- CO2 cycle for BGC -->
<entry id="co2_cycle_rad_passive" type="logical" category="co2_cycle"
group="camexp" valid_values="" >
Flag to set rad_climate variable so that the prognostic CO2 controlled by
the co2_cycle module is radiatively passive.
Default: FALSE
</entry>
<entry id="co2_flag" type="logical" category="co2_cycle"
group="co2_cycle_nl" valid_values="" >
If TRUE turn on CO2 code.
Default: FALSE
</entry>
<entry id="co2_readflux_fuel" type="logical" category="co2_cycle"
group="co2_cycle_nl" valid_values="" >
If TRUE read co2 flux from fuel.
Default: FALSE
</entry>
<entry id="co2_readflux_ocn" type="logical" category="co2_cycle"
group="co2_cycle_nl" valid_values="" >
If TRUE read co2 flux from ocn.
Default: FALSE
</entry>
<entry id="co2flux_ocn_file" type="char*256" input_pathname="abs" category="co2_cycle"
group="co2_cycle_nl" valid_values="" >
Filepath for dataset containing CO2 flux from ocn.
Default: none
</entry>
<entry id="co2flux_fuel_file" type="char*256" input_pathname="abs" category="co2_cycle"
group="co2_cycle_nl" valid_values="" >
Filepath for dataset containing CO2 flux from fossil fuel.
Default: none
</entry>
<!-- History and Initial Conditions Output -->
<entry id="avgflag_pertape" type="char*1(6)" category="history"
group="cam_inparm" valid_values="A,B,I,X,M" >
Sets the averaging flag for all variables on a particular history file
series. Valid values are:
A ==> Average
B ==> GMT 00:00:00 average
I ==> Instantaneous
M ==> Minimum
X ==> Maximum
The default is to use the averaging flags for each variable that are set in
the code via calls to subroutine addfld.
Defaults: set in code via the addfld and add_default subroutine calls.
</entry>
<entry id="empty_htapes" type="logical" category="history"
group="cam_inparm" valid_values="" >
If true don't put any of the variables on the history tapes by
default. Only output the variables that the user explicitly lists in
the <varname>fincl#</varname> namelist items. Default: FALSE
</entry>
<entry id="fexcl1" type="char*24(750)" category="history"
group="cam_inparm" valid_values="" >
List of fields to exclude from the 1st history file (by default the name
of this file contains the string "h0").
Default: none
</entry>
<entry id="fexcl2" type="char*24(750)" category="history"
group="cam_inparm" valid_values="" >
List of fields to exclude from the 2nd history file (by default the name
of this file contains the string "h1").
Default: none
</entry>
<entry id="fexcl3" type="char*24(750)" category="history"
group="cam_inparm" valid_values="" >
List of fields to exclude from the 3rd history file (by default the name
of this file contains the string "h2").
Default: none
</entry>
<entry id="fexcl4" type="char*24(750)" category="history"
group="cam_inparm" valid_values="" >
List of fields to exclude from the 4th history file (by default the name
of this file contains the string "h3").
Default: none
</entry>
<entry id="fexcl5" type="char*24(750)" category="history"
group="cam_inparm" valid_values="" >
List of fields to exclude from the 5th history file (by default the name
of this file contains the string "h4").
Default: none
</entry>
<entry id="fexcl6" type="char*24(750)" category="history"
group="cam_inparm" valid_values="" >
List of fields to exclude from the 6th history file (by default the name
of this file contains the string "h5").
Default: none
</entry>
<entry id="fincl1" type="char*26(750)" category="history"
group="cam_inparm" valid_values="" >
List of fields to include on the first history file (by default the name of
this file contains the string "h0"). The added fields must be in Master
Field List. The averaging flag for the output field can be specified by
appending a ":" and a valid averaging flag to the field name. Valid flags
are:
A ==> Average
B ==> GMT 00:00:00 average
I ==> Instantaneous
M ==> Minimum
X ==> Maximum
Default: set in code via the addfld and add_default subroutine calls.
</entry>
<entry id="fincl2" type="char*26(750)" category="history"
group="cam_inparm" valid_values="" >
Same as <varname>fincl1</varname>, but for the 2nd history file (by default
the name of this file contains the string "h1").
Default: none.
</entry>
<entry id="fincl3" type="char*26(750)" category="history"
group="cam_inparm" valid_values="" >
Same as <varname>fincl1</varname>, but for the 3rd history file (by default
the name of this file contains the string "h2").
Default: none.
</entry>
<entry id="fincl4" type="char*26(750)" category="history"
group="cam_inparm" valid_values="" >
Same as <varname>fincl1</varname>, but for the 4th history file (by default
the name of this file contains the string "h3").
Default: none.
</entry>
<entry id="fincl5" type="char*26(750)" category="history"
group="cam_inparm" valid_values="" >
Same as <varname>fincl1</varname>, but for the 5th history file (by default
the name of this file contains the string "h4").
Default: none.
</entry>
<entry id="fincl6" type="char*26(750)" category="history"
group="cam_inparm" valid_values="" >
Same as <varname>fincl1</varname>, but for the 6th history file (by default
the name of this file contains the string "h5").
Default: none.
</entry>
<entry id="clubb_history" type="logical" category="history"
group="clubb_his_nl" valid_values="" >
if .true. then output CLUBBs history statistics
</entry>
<entry id="clubb_rad_history" type="logical" category="history"
group="clubb_his_nl" valid_values="" >
if .true. then output CLUBBs radiative history statistics
</entry>
<entry id="clubb_vars_zt" type="char*16(10000)" category="history"
group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on zt grid.
Default: none.
</entry>
<entry id="clubb_vars_zm" type="char*16(10000)" category="history"
group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on zm grid.
Default: none.
</entry>
<entry id="clubb_vars_rad_zt" type="char*16(10000)" category="history"
group="clubb_stats_nl" valid_values="" >
Same as <varname>fincl1</varname>, but for CLUBB statistics on radiation zt grid.
Default: none.
</entry>
<entry id="clubb_vars_rad_zm" type="char*16(10000)" category="history"
group="clubb_stats_nl" valid_values="" >