Skip to content

Commit 4ad6733

Browse files
xylarxylar
authored
Merge pull request #1058 from eclare108213/snow2
New sea ice fields (pond area fraction, snow melt rate, and snow-ice formation rate) and updates to existing analyses
2 parents fe0668a + 07207bb commit 4ad6733

27 files changed

+1498
-92
lines changed

‎docs/developers_guide/api.rst

+3
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,9 @@ Sea ice tasks
127127
ClimatologyMapSeaIceConc
128128
ClimatologyMapSeaIceThick
129129
ClimatologyMapSeaIceSnowDepth
130+
ClimatologyMapSeaIceSnowiceFormation
131+
ClimatologyMapSeaIceSnowMelt
132+
ClimatologyMapSeaIcePondArea
130133
ClimatologyMapSeaIceAreaFractionRidge
131134
ClimatologyMapSeaIceVolumeRidge
132135
ClimatologyMapSeaIceAlbedo

‎docs/users_guide/analysis_tasks.rst

+6
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,12 @@ Analysis Tasks
5252
tasks/climatologyMapSeaIceSnowDepthNH
5353
tasks/climatologyMapSeaIceSnowDepthSH
5454

55+
tasks/climatologyMapSeaIceSnowiceFormationNH
56+
tasks/climatologyMapSeaIceSnowiceFormationSH
57+
tasks/climatologyMapSeaIceSnowMeltNH
58+
tasks/climatologyMapSeaIceSnowMeltSH
59+
tasks/climatologyMapSeaIcePondAreaNH
60+
tasks/climatologyMapSeaIcePondAreaSH
5561
tasks/climatologyMapSeaIceAreaFractionRidgeNH
5662
tasks/climatologyMapSeaIceAreaFractionRidgeSH
5763
tasks/climatologyMapSeaIceVolumeRidgeNH

‎docs/users_guide/tasks/climatologyMapSeaIceAlbedoNH.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ part of the averaging period and albedo is not well-defined.
1111
Component and Tags::
1212

1313
component: seaIce
14-
tags: climatology, horizontalMap, seaIceBroadbandAlbedo, publicObs, snow
14+
tags: climatology, horizontalMap, seaIceBroadbandAlbedo, publicObs, snow_on_sea_ice
1515

1616
Configuration Options
1717
---------------------

‎docs/users_guide/tasks/climatologyMapSeaIceAlbedoSH.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ part of the averaging period and albedo is not well-defined.
1111
Component and Tags::
1212

1313
component: seaIce
14-
tags: climatology, horizontalMap, seaIceBroadbandAlbedo, publicObs, snow
14+
tags: climatology, horizontalMap, seaIceBroadbandAlbedo, publicObs, snow_on_sea_ice
1515

1616
Configuration Options
1717
---------------------

‎docs/users_guide/tasks/climatologyMapSeaIcePondAreaNH.rst

+67
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
.. _task_climatologyMapSeaIcePondAreaNH:
2+
3+
climatologyMapSeaIcePondAreaNH
4+
=======================================
5+
6+
An analysis task for plotting maps of Arctic sea ice pond area fraction.
7+
8+
Component and Tags::
9+
10+
component: seaIce
11+
tags: climatology, horizontalMap, seaIcePondArea, publicObs
12+
13+
Configuration Options
14+
---------------------
15+
16+
The following configuration options are available for this task::
17+
18+
[climatologyMapSeaIcePondAreaNH]
19+
# options related to plotting horizontally remapped climatologies of
20+
# pond area fraction against control model results and observations
21+
# in the northern hemisphere (NH)
22+
23+
# colormap for model/observations
24+
colormapNameResult = deep
25+
# whether the colormap is indexed or continuous
26+
colormapTypeResult = indexed
27+
# color indices into colormapName for filled contours
28+
colormapIndicesResult = [20, 80, 110, 140, 170, 200, 230, 255]
29+
# colormap levels/values for contour boundaries
30+
colorbarLevelsResult = [0.001, 0.005, 0.01, 0.03, 0.05, 0.1, 0.2, 0.3, 0.4]
31+
32+
# colormap for differences
33+
colormapNameDifference = balance
34+
# whether the colormap is indexed or continuous
35+
colormapTypeDifference = indexed
36+
# color indices into colormapName for filled contours
37+
colormapIndicesDifference = [0, 32, 64, 96, 128, 128, 160, 192, 224, 255]
38+
# colormap levels/values for contour boundaries
39+
colorbarLevelsDifference = [-0.2, -0.1, -0.05, -0.01, -0.005, 0, 0.005, 0.01, 0.05, 0.1, 0.2]
40+
41+
# Months or seasons to plot
42+
seasons = ['FM', 'ON']
43+
44+
# comparison grid(s) (typically 'arctic_extended') on which to plot analysis
45+
comparisonGrids = ['arctic_extended']
46+
47+
# a list of prefixes describing the sources of the observations to be used
48+
observationPrefixes = ['']
49+
50+
# arrange subplots vertically?
51+
vertical = False
52+
53+
The option ``vertical = True`` can be used to plot 3 panels one above another
54+
(resulting in a tall, thin image) rather than next to each other, the default
55+
(resulting in a short, wide image).
56+
57+
For details on the remaining configration options, see:
58+
* :ref:`config_colormaps`
59+
* :ref:`config_seasons`
60+
* :ref:`config_comparison_grids`
61+
62+
Example Result
63+
--------------
64+
65+
.. image:: examples/ice_pondarea_nh.png
66+
:width: 720 px
67+
:align: center

‎docs/users_guide/tasks/climatologyMapSeaIcePondAreaSH.rst

+67
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
.. _task_climatologyMapSeaIcePondAreaSH:
2+
3+
climatologyMapSeaIcePondAreaSH
4+
=======================================
5+
6+
An analysis task for plotting maps of Antarctic sea ice pond area fraction.
7+
8+
Component and Tags::
9+
10+
component: seaIce
11+
tags: climatology, horizontalMap, seaIcePondArea, publicObs
12+
13+
Configuration Options
14+
---------------------
15+
16+
The following configuration options are available for this task::
17+
18+
[climatologyMapSeaIcePondAreaSH]
19+
# options related to plotting horizontally remapped climatologies of
20+
# snow melt against control model results and observations
21+
# in the southern hemisphere (SH)
22+
23+
# colormap for model/observations
24+
colormapNameResult = deep
25+
# whether the colormap is indexed or continuous
26+
colormapTypeResult = indexed
27+
# color indices into colormapName for filled contours
28+
colormapIndicesResult = [20, 80, 110, 140, 170, 200, 230, 255]
29+
# colormap levels/values for contour boundaries
30+
colorbarLevelsResult = [0.001, 0.005, 0.01, 0.03, 0.05, 0.1, 0.2, 0.3, 0.4]
31+
32+
# colormap for differences
33+
colormapNameDifference = balance
34+
# whether the colormap is indexed or continuous
35+
colormapTypeDifference = indexed
36+
# color indices into colormapName for filled contours
37+
colormapIndicesDifference = [0, 32, 64, 96, 128, 128, 160, 192, 224, 255]
38+
# colormap levels/values for contour boundaries
39+
colorbarLevelsDifference = [-0.2, -0.1, -0.05, -0.01, -0.005, 0, 0.005, 0.01, 0.05, 0.1, 0.2]
40+
41+
# Months or seasons to plot
42+
seasons = ['FM', 'ON']
43+
44+
# comparison grid(s) (typically 'antarctic_extended') on which to plot analysis
45+
comparisonGrids = ['antarctic_extended']
46+
47+
# a list of prefixes describing the sources of the observations to be used
48+
observationPrefixes = ['']
49+
50+
# arrange subplots vertically?
51+
vertical = False
52+
53+
The option ``vertical = True`` can be used to plot 3 panels one above another
54+
(resulting in a tall, thin image) rather than next to each other, the default
55+
(resulting in a short, wide image).
56+
57+
For details on the remaining configration options, see:
58+
* :ref:`config_colormaps`
59+
* :ref:`config_seasons`
60+
* :ref:`config_comparison_grids`
61+
62+
Example Result
63+
--------------
64+
65+
.. image:: examples/ice_pondarea_sh.png
66+
:width: 720 px
67+
:align: center

‎docs/users_guide/tasks/climatologyMapSeaIceSnowMeltNH.rst

+67
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
.. _task_climatologyMapSeaIceSnowMeltNH:
2+
3+
climatologyMapSeaIceSnowMeltNH
4+
=======================================
5+
6+
An analysis task for plotting maps of Arctic sea ice cell-averaged snow melt rate.
7+
8+
Component and Tags::
9+
10+
component: seaIce
11+
tags: climatology, horizontalMap, seaIceSnowMelt, publicObs
12+
13+
Configuration Options
14+
---------------------
15+
16+
The following configuration options are available for this task::
17+
18+
[climatologyMapSeaIceSnowMeltNH]
19+
# options related to plotting horizontally remapped climatologies of
20+
# snow melt against control model results and observations
21+
# in the northern hemisphere (NH)
22+
23+
# colormap for model/observations
24+
colormapNameResult = inferno
25+
# whether the colormap is indexed or continuous
26+
colormapTypeResult = indexed
27+
# color indices into colormapName for filled contours
28+
colormapIndicesResult = [20, 80, 110, 140, 170, 200, 230, 255]
29+
# colormap levels/values for contour boundaries
30+
colorbarLevelsResult = [0, 0.01, 0.02, 0.05, 0.1, 0.25, 0.5, 1., 1.5]
31+
32+
# colormap for differences
33+
colormapNameDifference = balance
34+
# whether the colormap is indexed or continuous
35+
colormapTypeDifference = indexed
36+
# color indices into colormapName for filled contours
37+
colormapIndicesDifference = [0, 32, 64, 96, 128, 128, 160, 192, 224, 255]
38+
# colormap levels/values for contour boundaries
39+
colorbarLevelsDifference = [-0.2, -0.1, -0.05, -0.01, -0.005, 0, 0.005, 0.01, 0.05, 0.1, 0.2]
40+
41+
# Months or seasons to plot
42+
seasons = ['ANN', 'FM', 'ON']
43+
44+
# comparison grid(s) (typically 'arctic_extended') on which to plot analysis
45+
comparisonGrids = ['arctic_extended']
46+
47+
# a list of prefixes describing the sources of the observations to be used
48+
observationPrefixes = ['']
49+
50+
# arrange subplots vertically?
51+
vertical = False
52+
53+
The option ``vertical = True`` can be used to plot 3 panels one above another
54+
(resulting in a tall, thin image) rather than next to each other, the default
55+
(resulting in a short, wide image).
56+
57+
For details on the remaining configration options, see:
58+
* :ref:`config_colormaps`
59+
* :ref:`config_seasons`
60+
* :ref:`config_comparison_grids`
61+
62+
Example Result
63+
--------------
64+
65+
.. image:: examples/ice_snowmelt_nh.png
66+
:width: 720 px
67+
:align: center

‎docs/users_guide/tasks/climatologyMapSeaIceSnowMeltSH.rst

+67
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
.. _task_climatologyMapSeaIceSnowMeltSH:
2+
3+
climatologyMapSeaIceSnowMeltSH
4+
=======================================
5+
6+
An analysis task for plotting maps of Antarctic sea ice cell-averaged snow melt rate.
7+
8+
Component and Tags::
9+
10+
component: seaIce
11+
tags: climatology, horizontalMap, seaIceSnowMelt, publicObs
12+
13+
Configuration Options
14+
---------------------
15+
16+
The following configuration options are available for this task::
17+
18+
[climatologyMapSeaIceSnowMeltSH]
19+
# options related to plotting horizontally remapped climatologies of
20+
# snow melt rate against control model results and observations
21+
# in the southern hemisphere (SH)
22+
23+
# colormap for model/observations
24+
colormapNameResult = inferno
25+
# whether the colormap is indexed or continuous
26+
colormapTypeResult = indexed
27+
# color indices into colormapName for filled contours
28+
colormapIndicesResult = [20, 80, 110, 140, 170, 200, 230, 255]
29+
# colormap levels/values for contour boundaries
30+
colorbarLevelsResult = [0, 0.01, 0.02, 0.05, 0.1, 0.25, 0.5, 1., 1.5]
31+
32+
# colormap for differences
33+
colormapNameDifference = balance
34+
# whether the colormap is indexed or continuous
35+
colormapTypeDifference = indexed
36+
# color indices into colormapName for filled contours
37+
colormapIndicesDifference = [0, 32, 64, 96, 128, 128, 160, 192, 224, 255]
38+
# colormap levels/values for contour boundaries
39+
colorbarLevelsDifference = [-0.2, -0.1, -0.05, -0.01, -0.005, 0, 0.005, 0.01, 0.05, 0.1, 0.2]
40+
41+
# Months or seasons to plot
42+
seasons = ['ANN', 'FM', 'ON']
43+
44+
# comparison grid(s) (typically 'antarctic_extended') on which to plot analysis
45+
comparisonGrids = ['antarctic_extended']
46+
47+
# a list of prefixes describing the sources of the observations to be used
48+
observationPrefixes = ['']
49+
50+
# arrange subplots vertically?
51+
vertical = False
52+
53+
The option ``vertical = True`` can be used to plot 3 panels one above another
54+
(resulting in a tall, thin image) rather than next to each other, the default
55+
(resulting in a short, wide image).
56+
57+
For details on the remaining configration options, see:
58+
* :ref:`config_colormaps`
59+
* :ref:`config_seasons`
60+
* :ref:`config_comparison_grids`
61+
62+
Example Result
63+
--------------
64+
65+
.. image:: examples/ice_snowmelt_sh.png
66+
:width: 720 px
67+
:align: center

‎docs/users_guide/tasks/climatologyMapSeaIceSnowiceFormationNH.rst

+67
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
.. _task_climatologyMapSeaIceSnowiceFormationNH:
2+
3+
climatologyMapSeaIceSnowiceFormationNH
4+
=======================================
5+
6+
An analysis task for plotting maps of Arctic sea ice cell-averaged snow-ice formation rate.
7+
8+
Component and Tags::
9+
10+
component: seaIce
11+
tags: climatology, horizontalMap, seaIceSnowiceFormation, publicObs
12+
13+
Configuration Options
14+
---------------------
15+
16+
The following configuration options are available for this task::
17+
18+
[climatologyMapSeaIceSnowiceFormationNH]
19+
# options related to plotting horizontally remapped climatologies of
20+
# snow-ice formation against control model results and observations
21+
# in the northern hemisphere (NH)
22+
23+
# colormap for model/observations
24+
colormapNameResult = cork
25+
# whether the colormap is indexed or continuous
26+
colormapTypeResult = indexed
27+
# color indices into colormapName for filled contours
28+
colormapIndicesResult = [20, 80, 110, 140, 170, 200, 230, 255]
29+
# colormap levels/values for contour boundaries
30+
colorbarLevelsResult = [0, 0.01, 0.05, 0.1, 0.25, 0.5, 0.75, 1.0, 1.5]
31+
32+
# colormap for differences
33+
colormapNameDifference = balance
34+
# whether the colormap is indexed or continuous
35+
colormapTypeDifference = indexed
36+
# color indices into colormapName for filled contours
37+
colormapIndicesDifference = [0, 32, 64, 96, 128, 128, 160, 192, 224, 255]
38+
# colormap levels/values for contour boundaries
39+
colorbarLevelsDifference = [-0.2, -0.1, -0.05, -0.02, -0.01, 0, 0.01, 0.02, 0.05, 0.1, 0.2]
40+
41+
# Months or seasons to plot
42+
seasons = ['ANN', 'FM', 'ON']
43+
44+
# comparison grid(s) (typically 'arctic_extended') on which to plot analysis
45+
comparisonGrids = ['arctic_extended']
46+
47+
# a list of prefixes describing the sources of the observations to be used
48+
observationPrefixes = ['']
49+
50+
# arrange subplots vertically?
51+
vertical = False
52+
53+
The option ``vertical = True`` can be used to plot 3 panels one above another
54+
(resulting in a tall, thin image) rather than next to each other, the default
55+
(resulting in a short, wide image).
56+
57+
For details on the remaining configration options, see:
58+
* :ref:`config_colormaps`
59+
* :ref:`config_seasons`
60+
* :ref:`config_comparison_grids`
61+
62+
Example Result
63+
--------------
64+
65+
.. image:: examples/ice_snowiceformation_nh.png
66+
:width: 720 px
67+
:align: center

0 commit comments

Comments
 (0)