/[MITgcm]/MITgcm/pkg/bling/bling_description.txt
ViewVC logotype

Contents of /MITgcm/pkg/bling/bling_description.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.5 - (show annotations) (download)
Thu Mar 16 17:03:26 2017 UTC (7 years, 1 month ago) by mmazloff
Branch: MAIN
CVS Tags: checkpoint66g, checkpoint66f, checkpoint66o, checkpoint66n, checkpoint66m, checkpoint66l, checkpoint66k, checkpoint66j, checkpoint66i, checkpoint66h, HEAD
Changes since 1.4: +4 -15 lines
File MIME type: text/plain
spring cleaning. minor changes

1 The "BLING" package is adapted from the Biogeochemistry with Light, Iron, Nutrient and Gas version two (BLINGv2) model developed at GFDL by Eric Galbraith and collaborators. Several subroutines, such as air-sea exchange and carbonate chemistry, are adapted from the "DIC" package. It is compatible with the MITgcm adjoint.
2
3 The original BLING model, described in Galbraith et al (2010), simulates a simplified ecosystem and the cycling of phosphorus, iron, carbon, and oxygen. Version two adds nitrogen cycling and more complexity to the ecosystem. It includes 3 phytoplankton classes.
4
5
6 For more information see:
7 -------------------------
8
9 Galbraith, E.D., Gnanadesikan, A., Dunne, J. and Hiscock, M. 2010. Regional impacts of iron-light colimitation in a global biogeochemical model. Biogeosciences, 7, 1043-1064.
10
11 http://www.gfdl.noaa.gov/simplified-ocean-biogeochemistry-bling
12
13 https://sites.google.com/site/blingmodel/
14
15
16
17 Below are the notes from the original file generic_BLING.v2.F90:
18 ----------------------------------------------------------------
19
20 Biogeochemistry with Light, Iron, Nutrient and Gas version two (BLINGv2) includes an implicit ecological model of growth limitation by light, temperature, nitrogen, phosphorus and iron, and simulates organic and O2 pools.
21
22 BLINGv2 differs from blingv0 by including a nitrogen cycle (with N2 fixation and denitrification) and flexible N:P stoichiometry. The iron limitation is now treated slightly differently, in order to be consistent with P. In addition, the phytoplankton biomass is now treated as a non-advected tracer (i.e. a diagnostic tracer in GFDL parlance) for the purpose of calculating uptake, which relaxes the strict assumption of balanced growth. There is also a subgridscale sediment parameterization, to capture fine-scale bathymetric features in particle remineralization, and a diel vertical migrator (DVM) parameterization for export and remineralization. In addition, there are numerous small changes and re-tunings.
23
24 Food web processing in the euphotic zone is handled following the empirical relationships discussed by Dunne et al.(2005). O2 equilibria and gas exchange follow OCMIP2 protocols.
25
26 BLING is a biogeochemistry tool, with ecosystem-like behaviour, rather than a full-complexity ecosystem model. It takes certain computational shortcuts in order to represent well-known features of ecosystems, but without having to resolve the ecosystem components explicitly. Most importantly, living and particulate organic matter is not subject to advection and mixing due to ocean circulation. Particular caution should be applied when interpreting small-scale behaviour (scales of advection per week) and the detailed timing of growth in dynamic environments, such as during spring blooms.
27
28 Additional functionality comes from an optional carbon cycle that is non-interactive, i.e. does not change the core bling behaviour, as well as tracers including radiocarbon (14c), d13C (13c), a decomposition of carbon components by gas exchange and remineralization (carbon_pre), a nutrient source tagging module (nut_source) that uses a global pycnocline (pyc_ave), a decomposition of oxygen as preformed and total (o2_pre) as well as photosynthetic, and a decomposition of phosphate and nitrate as preformed and remineralized (nut_pre). All of this - and more! - is found in the module BLING_extras.
29
30 This model is available for public use. The current version is blingv2. The version number refers to the core model behaviour; additional tracers exist in different iterations of the module. There is not yet a publication. blingv0 can be referenced as:
31 Galbraith, E.D., Gnanadesikan, A., Dunne, J. and Hiscock, M. 2010. Regional impacts of iron-light colimitation in a global biogeochemical model. Biogeosciences, 7, 1043-1064.
32
33 All parameter values are as described in this paper. Note that this reference is only for the core model components, and does not include any of the additional functionalities, which remain undocumented. Please contact Eric Galbraith (eric.galbraith@mcgill.ca) for more information.
34
35
36
37
38
39
40
41 Notes on running BLING in MITgcm:
42 ---------------------------------
43
44 (See the example in MITgcm_contrib/verification_other/global_oce_biogeo_bling)
45
46 1) make sure that you have the current BLING code:
47 in your pkg/bling directory
48 type:
49 cvs update
50
51 2) in your code folder, add these to packages.conf:
52 gchem
53 ptracers
54 bling
55
56 3) in your code folder, copy pkg/bling/BLING_OPTIONS.h
57 and define / undef options
58
59 4) in your run folder, add
60 data.gchem (useBLING=.TRUE.)
61 data.ptracers (specify ICS for ptracers)
62 data.bling (specify atm pCO2, silica field, iron atm deposition field)
63 You can find examples of these files in MITgcm_contrib/verification_other/global_oce_biogeo_bling/input/
64
65 5) in your run folder, update
66 data.pkg (usePTRACERS=.TRUE., useGCHEM=.TRUE.)
67 and if you use it
68 data.obcs or data.rbcs (specify OBCS for ptracers)
69
70
71
72
73
74
75 BLING-specific options (to be specified in BLING_OPTIONS.h):
76 ------------------------------------------------------------
77
78 BLING_NO_NEG
79 When biogeochemical tracer fields become negative (which can happen when advecting fields with low values and high spatial gradients), change negative values to small positive values before nutrient limitations are calculated in bling_production.
80
81 ML_MEAN_LIGHT
82 Assume that phytoplankton in the mixed layer experience the average light over the mixed layer (as in original BLING model)
83
84 ML_MEAN_PHYTO
85 Assume that phytoplankton are homogenized in the mixed layer
86
87 ADVECT_PHYTO
88 Adds a tracer for total phytoplankton biomass
89
90 BLING_ADJOINT_SAFE
91 Simplify some parts of the code that are problematic when using the adjoint
92
93 USE_EXFQSW
94 Determine PAR from shortwave radiation from EXF package (instead of from an input file or from location & time)
95
96 USE_EXF_ATMPRES
97 Atmospheric pressure from EXF package (in N/m2, convert to bars)
98
99 *** to be specified in EXF_OPTIONS.h ***
100 USE_EXFCO2
101 Read atmospheric pCO2 values from EXF package
102
103
104
105
106 Notes on BLING_ADJOINT SAFE:
107
108 - minimum value for Pc_m and Pc_m_diaz
109 - FreeFe and pfeflux_l are not set to 0 when anoxic
110 - using fixed wsink0 rather than variable wsink in organic Fe adsorption calculation
111 - no benthic denitrification
112 - no DVM
113
114
115
116
117
118
119 List of BLING subroutines with short description:
120 -------------------------------------------------
121
122 C =================================================================
123 C | subroutine bling_airseaflux
124 C | o Calculate the carbon and oxygen air-sea flux terms
125 C | Adapted from pkg/dic/dic_surfforcing.F
126 C | - Get atmospheric pCO2 value
127 C | Option 1: constant value, default 268.d-6, can be changed in
128 C | data.bling
129 C | Option 2: read 2D field using EXF pkg
130 C | - Update pCO2 and pH
131 C =================================================================
132
133 C ==========================================================
134 C | subroutine bling_carbonate_init
135 C | o Calculate first guess of pH
136 C | Adapted from pkg/dic/dic_surfforcing_init.F
137 C ==========================================================
138
139 C =================================================================
140 C | subroutine bling_carbonate_sys
141 C | o Calculate carbonate fluxes
142 C | Also update pH (3d field)
143 C =================================================================
144
145 C =================================================================
146 C | subroutine bling_carbon_chem
147 C | o Calculates ocean inorganic carbon chemistry
148 C | Adapted from pkg/dic/carbon_chem.F
149 C | from OCMIP2 code
150 C =================================================================
151
152 C =================================================================
153 C | subroutine bling_cost
154 C | o Define cost contribution from bling variables
155 C =================================================================
156
157 C =================================================================
158 C | subroutine bling_diagnostics_init
159 C | o Define diagnostics for bling pkg
160 C =================================================================
161
162 C =================================================================
163 C | subroutine bling_dvm
164 C | o Diel Vertical Migration
165 C | {note: implemented precariously. Has not been tested.}
166 C =================================================================
167
168 C ==========================================================
169 C | subroutine bling_fields_load
170 C | o Read in fields needed for CO2, O2 flux terms, silica
171 C | for pH calculation
172 C ==========================================================
173
174 C ==========================================================
175 C | subroutine bling_ini_forcing
176 C | o Initialize forcing fields
177 C ==========================================================
178
179 C ==========================================================
180 C | subroutine bling_init_fixed
181 C | o Initialize fixed parameters
182 C ==========================================================
183
184 C ==========================================================
185 C | subroutine bling_init_varia
186 C | o Initialize variable parameters
187 C ==========================================================
188
189 C =================================================================
190 C | subroutine bling_light
191 C | o calculate effective light for phytoplankton growth
192 C | There are multiple types of light.
193 C | - irr_inst is the instantaneous irradiance field.
194 C | - irr_mix is the same, but with irradiance averaged over
195 C | the mixed layer. This quantity is intended to represent the
196 C | light to which phytoplankton subject to turbulent transport in
197 C | the mixed-layer would be exposed.
198 C | - irr_mem is a temporally smoothed field carried between
199 C | timesteps, to represent photoadaptation.
200 C | - irr_eff is the effective irradiance for photosynthesis,
201 C | given either by irr_inst or irr_mix, depending on model
202 C | options and location.
203 C =================================================================
204
205 C ==================================================================
206 C | subroutine bling_main
207 C | o Updates all the tracers for the effects of air-sea exchange,
208 C | biological production, and remineralization.
209 C | - The basic model includes 8 tracers
210 C | - There is an optional tracer for phytoplankton biomass
211 C | - River runoff is included here
212 C ==================================================================
213
214 C =================================================================
215 C | subroutine bling_mixedlayer
216 C | o Calculate mixed layer depth based on density criterion
217 C =================================================================
218
219 C =================================================================
220 C | subroutine bling_prod
221 C | o Nutrient uptake and partitioning between organic pools.
222 C | - Phytoplankton specific growth rate is calculated
223 C | as a function of light, nutrient limitation, and
224 C | temperature.
225 C | - Population growth is calculated as a function of the local
226 C | phytoplankton biomass.
227 C =================================================================
228
229 C ==========================================================
230 C | subroutine bling_readparms
231 C | o Initialise and read parameters for BLING model
232 C ==========================================================
233
234 C ==========================================================
235 C | subroutine bling_read_pickup
236 C | o Read BLING arrays from a pickup file
237 C ==========================================================
238
239 C =================================================================
240 C | subroutine bling_remin
241 C | o Organic matter export and remineralization.
242 C | - Sinking particulate flux and diel migration contribute to
243 C | export.
244 C | - Benthic denitrification
245 C | - Iron source from sediments
246 C | - Iron scavenging
247 C =================================================================
248
249 C =================================================================
250 C | subroutine bling_write_pickup
251 C | o Writes BLING arrays (needed for a restart) to a pickup file
252 C =================================================================
253
254 C =================================================================
255 C | subroutine bling_min_val
256 C | o replaces tracer values that are too small or negative
257 C | (in a separate routine so can be hidden from adjoint)
258 C =================================================================
259
260
261
262
263
264
265
266
267
268
269
270

  ViewVC Help
Powered by ViewVC 1.1.22