EcoGEnIE 0 . 1 : Plankton Ecology in the cGENIE Earth system model

We present an extension to the cGENIE Earth System model that explicitly accounts for the growth and interaction of an arbitrary number of plankton species. The new package (‘ECOGEM’) replaces the implicit, flux-based, parameterisation of the plankton community currently employed, with explicitly resolved plankton populations and ecological dynamics. In ECOGEM, any number of plankton species, with ecophysiological traits (e.g. growth and grazing rates) assigned according 5 to organism size and functional group (e.g. phytoplankton and zooplankton) can be incorporated at run-time. We illustrate the capability of the marine ecology enabled Earth system model (‘EcoGENIE’) by comparing results from one configuration of ECOGEM (with eight generic phytoplankton and zooplankton size classes) to climatological and seasonal observations. We find that the new ecological components of the model show reasonable agreement with both global-scale climatological 10 and local-scale seasonal data. We also compare EcoGENIE results to a the existing biogeochemical incarnation of cGENIE. We find that the resulting global-scale distributions of phosphate, iron, dissolved inorganic carbon, alkalinity and oxygen are similar for both iterations of the model. A slight deterioration in some fields in EcoGENIE (relative to the data) is observed, although we make no attempt to re-tune the overall marine cycling of carbon and nutrients here. The increased capa15 bilities of EcoGENIE in this regard will enable future exploration of the ecological community on much longer timescales than have previously been examined in global ocean ecosystem models and particularly for past climates and global biogeochemical cycles.


Introduction
The marine ecosystem is an integral component of the Earth system and its dynamics.Photosynthetic plankton ultimately support almost all life in the ocean, including the fish stocks that provide essential nutrition to more than half the human population (Hollowed et al., 2013).In addition, the marine biota determine an important downward flux of carbon, known as the "biological pump".This flux arises as biomass generated by photosynthesis in the well-lit ocean surface sinks into the dark ocean interior, where it is remineralised (e.g.Hülse et al., 2017).Modulated by the activity and composition of marine ecosystems, the biological pump increases the partial pressure of CO 2 at depth and decreases it in the ocean surface and atmosphere, and thus plays a key role in the regulation of Earth's climate.For instance, the existence of the biological carbon pump has been estimated to be responsible for an approximately 200 ppm decrease in atmospheric carbon concentration at steady state (Parekh et al., 2006), with variations in its magnitude being cited as playing a key role in, for example, the late Quaternary glacialinterglacial climate oscillations (Watson et al., 2000;Hain et al., 2014).
A variety of different marine biogeochemical modelling approaches has been developed in an attempt to understand how the marine carbon cycle functions and its dynamical interaction with climate, and to make both past and future projections.In the simplest of these approaches, the biological pump is incorporated into an ocean circulation (or box) model without explicitly including any state variables for the biota.Such models have been described as models of "bio-Published by Copernicus Publications on behalf of the European Geosciences Union.
genically induced chemical fluxes" (rather than explicitly of the biology -and ecology -itself; Maier-Reimer, 1993).They vary considerably in complexity but can be broadly divided into two categories.In the first of these, "nutrientrestoring" models calculate the biological uptake of nutrients at any one point at the ocean surface as the flux required to maintain surface nutrient concentrations at observed values (e.g.Bacastow and Maier-Reimer, 1990;Najjar et al., 1992).The vertical flux is then remineralised at depth according to some attenuating profile, such as that of Martin et al. (1987).Within this framework, carbon export is typically calculated from the nutrient flux according to a fixed stoichiometric ("Redfield") ratio (Redfield, 1934).In addition to the availability of a spatially explicit (in the case of ocean circulation models) observed surface ocean nutrient field, nutrientrestoring models inherently only require a single parameter -the restoring timescale -and even this parameter is not critical (as long as the timescale is sufficiently short that the model closely reproduces the observed nutrient concentrations).The simplicity of this approach lends itself to being able to focus on a very specific part of the ecosystem dynamics, namely the downward transport of organic matter, and was highly influential, particularly during the early days of marine biogeochemical model development and assessment of carbon uptake and transport dynamics (e.g.Marchal et al., 1998;Najjar et al., 1992).However, because this approach is based explicitly upon observed values (or modified observations), they are primarily only suitable for diagnostic and modern steady-state applications and are unable to model any deviations of nutrient cycling, and hence of climate, from the current ocean state.
More sophisticated models of biogenically induced chemical fluxes do away with a direct observational constraint and instead estimate the organic matter export term on the basis of limiting factors, such as temperature, light, and the availability of nutrients such as nitrogen, phosphorous, and iron -an approach we will here refer to as "nutrient limitation".Models based on this approach (e.g.Bacastow and Maier-Reimer, 1990;Heinze et al., 1991;Archer and Johnson, 2000) were natural successors to the early nutrient-restoring models and could account for the influence of multiple limiting nutrients and even implicitly partition export between different functional types (Watson et al., 2000).Without entraining an explicit dependence on observed surface ocean nutrient distributions, these models also gain much more freedom and, with it, a degree of predictive capability.Additionally, other than plausible values for nutrient halfsaturation constants, nutrient-limitation models make few assumptions that are specifically tied to modern observations and assume very little (if anything) about the particular organisms present.Hence, as long as one makes the assumption that the marine plankton that existed at some specific time in the past were physiologically similar, particularly in terms of fundamental nutrient requirements, there is no apparent reason why nutrient-limitation models will not be as applicable to much of the Phanerozoic in terms of geological past, as they are to the present (questions of how suitable they might be to the present in the first place aside).Using nutrient-limitation flux schemes, marine biogeochemical cycles have hence already been simulated for periods such as the mid-Cretaceous (Monteiro et al., 2012) and end-Permian (Meyer et al., 2008), times for which surface nutrient distributions are not known a priori.
The disadvantage of both variants of models of biogenically induced chemical fluxes is that they are not able to represent interactions between parts of the ecosystem (e.g.resource competition and predator-prey interactions), simply because these components and processes are not resolved.Nor can they address questions involving the addition or loss, such as those associated with past extinction events, of plankton species and changes in ecosystem complexity and/or structure.They also suffer from being overly responsive to changes in nutrient availability.In the case of restoring models, this is simply because any change in the target field will be closely tracked.In the case of the nutrientlimitation models, the lack of an explicit biomass term results in export fluxes changing instantaneously in response to changing limiting factors.In the real world, by contrast, sufficient biomass must first exist, such as in a bloom condition, in order to achieve maximal export.This has consequences for how the seasonality of organic matter export is represented.Other restrictions include the inability to know anything about ecosystem size structure (and, by association, about particle sinking speed) or the degree of recycling at the ocean surface and hence the partitioning of carbon into dissolved vs. particulate phases in exported organic matter.
To allow models to respond to changes in ecosystem structure, and to incorporate some of the additional feedbacks and complexities that may be important in determining the future marine response to continued greenhouse gas emissions (Le Quéré et al., 2005), it has been necessary to explicitly resolve the ecosystem itself.Such models have been developed across a wide range of complexities (Kwiatkowski et al., 2014).Among the simplest are nutrientphytoplankton-zooplankton-detritus (NPZD)-type models, resolving a single nutrient, homogenous phytoplankton and zooplankton communities, and a single detrital pool (Wroblewski et al., 1988;Oschlies, 2001).At the other end of the spectrum, more complex models may include multiple nutrients and several plankton functional types (PFTs) (e.g.Aumont et al., 2003;Moore et al., 2002;Le Quéré et al., 2005).What links these models is that the living state variables are very broadly based on ecological guilds (i.e.groups of organisms that exploit similar resources).
While simple NPZD models are capable of reproducing some of the observed variability in bulk properties such as chlorophyll biomass and primary production (Schartau and Oschlies, 2003b;Yool et al., 2013;Ward et al., 2013), their very simplicity precludes the representation of many potentially important biogeochemical processes and climate feed-backs.Additionally, NPZD models are parameterised to represent the activity of diverse plankton communities, with different parameter values being required as the ecosystem changes in space and time (Schartau and Oschlies, 2003a;Losa et al., 2006).In this regard, PFT models may be more generally applicable because they resolve relatively more fundamental ecological processes that may be less sensitive to environmental variability (Friedrichs et al., 2007).These are the key factors that have motivated the development of more complex models, in which the broad ecological guilds of NPZD models are replaced with more specific groups based on ecological and/or biogeochemical function (Aumont et al., 2015;Butenschön et al., 2016).It is argued that resolving more components of the ecosystem allows the representation of important climate feedbacks that cannot be accounted for in simpler models (Le Quéré, 2006).
However, alongside their advantages, the current generation of PFT models is faced with two important and conflicting challenges.Firstly, these complex models contain a large number of parameters that are often poorly constrained by observations (Anderson, 2005).Secondly, although PFT models resolve more ecological structure than the preceding generation of ocean ecosystem models, they are rarely general enough to perform well across large environmental gradients (Friedrichs et al., 2006(Friedrichs et al., , 2007;;Ward et al., 2010).To these, one might add difficulties in their application to past climates.PFT models are based on a conceptual reduction of the modern marine ecosystem to its apparent key biogeochemical components, such as nitrogen fixation, or opal frustule production (as by diatoms).The role of diatoms and the attendant cycling of silica quickly become moot once one looks back in Earth history, as the origin of diatoms is thought to be sometime early in the Mesozoic (252-66 Ma), and they did not proliferate and diversify until later in the Cenozoic (66-0 Ma) (Falkowski et al., 2004).In addition, the physiological details of each species encoded in the model are taken directly from laboratory culture experiments of isolated strains (Le Quéré et al., 2005) creating a parameter dependence on modern cultured species, in addition to a structural one.
Recent studies have begun to address these issues by focusing on the more general rules that govern diversity (rather than by trying to quantify and parameterise the diversity itself).These "trait-based" models are beginning to be applied in the field of marine biogeochemical modelling (e.g.Follows et al., 2007;Bruggeman and Kooijman, 2007), with a major advantage being that they are able to resolve greater diversity with fewer specified parameters.One of the main challenges of this approach then is to identify the general rules or trade-offs that govern competition between organisms (Follows et al., 2007;Litchman et al., 2007).These trade-offs are often strongly constrained by organism size.A potentially large number of different plankton size classes can therefore be parameterised according to well-known allometric relationships linking plankton physiological traits to organism size (e.g.Tang, 1995;Hansen et al., 1997).This approach has the associated advantage that the size composition of the plankton community affects the biogeochemical function of the community (e.g.Guidi et al., 2009).If one assumes that the same allometric relationships and trade-offs are relatively invariant with time, then this approach provides a potential way forward to addressing geological questions.
In this paper, we present an adaptable modelling framework with an ecological structure that can be easily adapted according to the scientific question at hand.The model is formulated so that all plankton are described by the same set of equations, and any differences are simply a matter of parameterisation.Within this framework, each plankton population is characterised in terms of its size-dependent traits and its distinct functional type.The model also includes a realistic physiological component, based on a cell quota model (Caperon, 1968;Droop, 1968) and a dynamic photoacclimation model (Geider et al., 1998).This physiological component increases model realism by allowing phytoplankton to flexibly take up nutrients according to availability, rather than according to an unrealistically rigid cellular stoichiometry.Such flexible stoichiometry is rarely included in large-scale ocean models and provides the opportunity to study the links between plankton physiology, ecological competition, and biogeochemistry.This model is then embedded within the carbon-centric Grid Enabled Integrated Earth system model (cGEnIE) widely used in addressing questions of past climate and carbon cycling, and the overall properties of the model system are evaluated.
The structure of this paper is as follows.In Sect.2, we will briefly outline the nature and properties of the cGEnIE Earth system model, focusing on the ocean circulation and marine biogeochemical modules most directly relevant to the simulation of marine ecology.In Sect.3, we introduce the new ecological model -ECOGEM -that has been developed within the cGEnIE framework.Section 4 describes the preliminary experiments of ECOGEM, and Sect. 5 presents results from the new integrated ecological global model (Eco-GEnIE) in comparison to observations (where available) as well as to the pre-existing biogeochemical simulation of cGEnIE.

The GEnIE/cGEnIE Earth system model
GEnIE is an Earth system model of intermediate complexity (EMIC) (Claussen et al., 2002) and is based on a modular framework that allows different components of the Earth system, including ocean circulation, ocean biogeochemistry, deep-sea sediments, and geochemistry, to be incorporated (Lenton et al., 2007).The simplified atmosphere and carboncentric version of GEnIE we use -cGEnIE -has been previously applied to explore and understand the interactions between biological productivity, biogeochemistry, and climate over a range of timescales and time periods (e.g.Ridgwell www.geosci-model-dev.net/11/4241/2018/Geosci.Model Dev., 11, 4241-4267, 2018 andSchmidt, 2010;Monteiro et al., 2012;Norris et al., 2013;John et al., 2014;Gibbs et al., 2015;Meyer et al., 2016;Tagliabue et al., 2016).As is common for EMICs, cGEnIE features a decreased spatial and temporal resolution in order to facilitate the efficient simulation of the various interacting components.This imposes limits on the resolution of ecosystem dynamics to large-scale annual/seasonal patterns in contrast to higher resolutions often used to model modern ecosystems.However, our motivation for incorporating a new marine ecosystem module into cGEnIE is to focus on the explicit interactions between ecosystems, biogeochemistry, and climate that are computationally prohibitive in higherresolution models.In other words, our motivation is to include and explore a more complete range of interactions and dynamics within the marine system, at the expense of spatial fidelity and with the intention to explore long timescale and paleoceanographic questions, rather than short-term and future anthropogenic concerns.

Ocean physics and climate model component -C-GOLDSTEIN
The fast climate model, C-GOLDSTEIN features a reduced physics (frictional geostrophic) 3-D ocean circulation model coupled to a 2-D energy-moisture balance model of the atmosphere and a dynamic-thermodynamic sea-ice model.
Full descriptions of the model can be found in Edwards and Marsh (2005a) and Marsh et al. (2011).
The circulation model calculates the horizontal and vertical transport of heat, salinity, and biogeochemical tracers via the combined parameterisation for isoneutral diffusion and eddy-induced advection (Edwards and Marsh, 2005a;Marsh et al., 2011).The ocean model is configured on a 36 × 36 equal-area horizontal grid with 16 logarithmically spaced z-coordinate levels.The horizontal grid is generally constructed to be uniform in longitude (10 • resolution) and uniform in the sine of latitude (varying in latitude from ∼ 3.2 • at the Equator to 19.2 • near the poles).The thickness of the vertical grid increases with depth, from 80.8 m at the surface to as much as 765 m at depth.The degree of spatial and temporal abstraction in C-GOLDSTEIN results in parameter values that are not well known and require calibration against observations.The parameters for C-GOLDSTEIN were calibrated against annual mean climatological observations of temperature, salinity, surface air temperature, and humidity using the ensemble Kalman filer (EnKF) methodology (Hargreaves et al., 2004;Ridgwell et al., 2007a).The parameter values for C-GOLDSTEIN used are those reported for the 16-level model in Table S1 of Cao et al. (2009) under "GEnIE16".C-GOLDSTEIN is run with 96 time steps per year.The resulting circulation is dynamically similar to that of classical general circulation models based on the primitive equations but is significantly faster to run and in this configuration performs well against standard tests of circulation models such as anthropogenic CO 2 and chlorofluorocarbon (CFC) uptake, as well as in reproducing the deep-ocean radiocarbon ( 14 C) distribution (Cao et al., 2009).

Ocean biogeochemical model component -BIOGEM
Transformations and spatial redistribution of biogeochemical compounds both at the ocean surface (by biological uptake) and in the ocean interior (remineralisation), plus air-sea gas exchange, are handled by the module BIOGEM.In the pre-existing version of BIOGEM, the biological (soft-tissue) pump is driven by an implicit (i.e.unresolved) biological community (in place of an explicit representation of living microbial community).It is therefore a nutrient-limitation variant of a model of biogenically induced chemical fluxes, as outlined above.A full description can be found in Ridgwell et al. (2007a) and Ridgwell and Death (2018).
In this study, we use a seasonally insolation forced 16level ocean model configuration, similar to that of Cao et al. (2009).However, in the particular biogeochemical configuration we use, limitation of biological uptake of carbon is provided by the availability of two nutrients.In addition to phosphate, we now include an iron cycle following Tagliabue et al. (2016).This aspect of the model is determined by a revised set of parameters controlling the iron cycle (Ridgwell and Death, 2018).We also incorporate a series of minor modifications to the climate model component, particularly in terms of the ocean grid and wind velocity and stress forcings (consistent with Marsh et al., 2011) together with associated changes to several of the physics parameters.A complete description and evaluation of the physical and biogeochemical configuration of cGEnIE is provided in Ridgwell and Death (2018).

Ecological model component -ECOGEM
The current BIOGEM module in cGEnIE does not explicitly resolve the biological community and instead transforms surface inorganic nutrients directly into exported nutrients or dissolved organic matter (DOM):

DOM
and remineralised nutrients This simplification greatly facilitates the efficient modelling of the carbon cycle over long timescales but with the associated caveats of an implicit scheme (as discussed earlier).In ECOGEM, biological uptake is again limited by light, temperature, and nutrient availability, but here it must pass through an explicit and dynamic intermediary plankton community, before being returned to DOM or dissolved inorganic nutrients: The ecological community is also subject to mortality and internal trophic interactions, and will produce both inorganic compounds and organic matter.The structural relationship between BIOGEM and ECOGEM is illustrated in Fig. 1.
In the following section, we outline the key state variables directly relating to ecosystem function (Sect.3.1) describe the mathematical form of the key rate processes relating to each state variable (Sect.3.2) and how they link together (Sect.3.3).We will then describe the parameterisation of the model according to organism size and functional type (Sect.3.4).The model equations are modified from Ward et al. (2012).We provide all the equations used in ECOGEM here, but we provide only brief descriptions of the parameterisations and parameter value justifications already included in Ward et al. (2012).

State variables
ECOGEM state variables are organised into three matrices (Table 1), representing ecologically relevant biogeochemical tracers (hereafter referred to as "nutrient resources"), plankton biomass, and organic matter.All these matrices have units of mmol element m −3 , with the exception of the dynamic chlorophyll quota, which is expressed in units of mg chlorophyll m −3 .The nutrient resource vector (R) includes I r distinct inorganic resources.The plankton community (B) is made up of J individual populations, each associated with I b cellular nutrient quotas.Finally, organic matter (D) is made up of K size classes of organic matter, each containing i d organic nutrient element pools.(Note that, strictly speaking, detrital organic matter is not explicitly resolved as a state variable in ECOGEM, as we currently only resolve the production of organic matter, which is passed to BIOGEM and held there as a state variable.As a consequence, there is no grazing on detrital organic matter in the current configuration of EcoGEnIE.We include a description of D and its relationships here for completeness and for convenience of notation.)

Inorganic resources
R is a row vector of length I r , the number of dissolved inorganic nutrient resources.
An individual inorganic resource is denoted by the appropriate subscript.For example, PO 4 is denoted R PO 4 .

Plankton biomass
B is a J × I b matrix, where J is the number of plankton populations and I b is the number of cellular quotas, including chlorophyll.
Each population and element are denoted by an appropriate subscript.For example, the total carbon biomass of plankton population j is denoted B j,C , while the chlorophyll biomass of that population is denoted B j,Chl .The column vector describing the carbon content of all plankton populations is denoted B C .This framework can account for competition between (in theory) any number of different plankton populations.The model equations (below) are written in terms of an "ideal" planktonic form, with the potential to exhibit the full range of ecophysiological traits (among those that are included in the Each size class and element are denoted by an appropriate subscript.For example, dissolved organic phosphorus (size class k = 1) is denoted D 1,P , while particulate organic iron (size class k = 2) is denoted D 2,Fe .

Plankton physiology and ecology
The rates of change in each state variable within ECOGEM are defined by a range of ecophysiological processes.These are defined by a set of mathematical functions that are common to all plankton populations.Parameter values are defined in Sect.3.4.

Temperature limitation
Temperature affects a wide range of metabolic processes through an Arrhenius-like equation that is here set equal for all plankton.
The parameter A describes the temperature sensitivity, T is the ambient water temperature in • C, and T ref is a reference temperature (also in • C) at which γ T = 1.

The plankton "quota"
The physiological status of a plankton population is defined in terms of its cellular nutrient quota, Q, which is the ratio of assimilated nutrient (phosphorus or iron) to carbon biomass.
For each plankton population, j , and each planktonic quota, This equation is also used to describe the population chlorophyll content relative to carbon biomass.The size of the quota increases with nutrient uptake or chlorophyll synthesis.The quota decreases through the acquisition of carbon (described below).
Excessive accumulation of P or Fe biomass in relation to carbon is prevented as the uptake or assimilation of each nutrient element is down-regulated as the respective quota becomes full.The generic form of the uptake regulation term for element i b is given by a linear function of the nutrient status, modified by an additional shape parameter (h = 0.1; Geider et al., 1998) that allows greater assimilation under low-to-moderate resource limitation.

Nutrient uptake
Phosphate and dissolved iron (i r = i b = P or Fe) are taken up as functions of environmental availability ([R i r ]), maximum uptake rate (V max j,i r ), the nutrient affinity (α j,i r ), the quota satiation term, (Q stat j,i b ), and temperature limitation (γ T ): This equation is equivalent to the Michaelis-Menten-type response but replaces the half-saturation constant with the more mechanistic nutrient affinity, α j,i r .

Photosynthesis
The photosynthesis model is modified from Geider et al.
(1998) and Moore et al. (2002).Light limitation is calculated as a Poisson function of local irradiance (I ), modified by the iron-dependent initial slope of the P-I curve (α • γ j,Fe ) and the chlorophyll a : carbon ratio (Q j,Chl ).
Geosci.Model Dev., 11, 4241-4267, 2018 www.geosci-model-dev.net/11/4241/2018/Here, P sat j,C is maximum light-saturated growth rate, modified from an absolute maximum rate of P max j,C , according to the current nutrient and temperature limitation terms.
The nutrient-limitation term is given as a minimum function of the internal nutrient status (Droop, 1968;Caperon, 1968;Flynn, 2008), each defined by normalised hyperbolic functions for P and Fe (i b = P or Fe): The gross photosynthetic rate (P j,C ) is then modified from P sat j,C by the light-limitation term.
Net carbon uptake is given by with the second term accounting for the metabolic cost of biosynthesis (ξ ).This parameter was originally defined as a loss of carbon as a fraction of nitrogen uptake (Geider et al., 1998).We define it here relative to phosphate uptake, using a fixed N : P ratio of 16.

Photoacclimation
The chlorophyll : carbon ratio is regulated as the cell attempts to balance the rate of light capture by chlorophyll with the maximum potential (i.e.light-replete) rate of carbon fixation.Depending on this ratio, a certain fraction of newly assimilated phosphorus is diverted to the synthesis of new chlorophyll a: Here, ρ j,Chl is the amount of chlorophyll a that is synthesised for every millimole of phosphorus assimilated (mg Chl (mmol P) −1 ) with θ max P representing the maximum ratio (again converting from the nitrogen-based units of Geider et al., 1998, with a fixed N : P ratio of 16).If phosphorus is assimilated at a carbon-specific rate V j,P (mmol P (mmol C) −1 d −1 ), then the carbon specific rate of chlorophyll a synthesis (mg Chl (mmol C) (14)

Light attenuation
In both BIOGEM and ECOGEM, the incoming shortwave solar radiation intensity is taken from the climate component in cGEnIE and varies seasonally (Edwards and Marsh, 2005b;Marsh et al., 2011).However, ECOGEM uses a slightly more complex light-attenuation scheme than BIOGEM, which simply calculates a mean solar (shortwave) irradiance averaged over the depth of the surface layer, assuming a clear-water light-attenuation scale of 20 m (Doney et al., 2006).
In ECOGEM, the light level is calculated as the mean level of photosynthetically available radiation within a variable mixed layer (with depth calculated according to Kraus and Turner, 1967).We also take into account inhibition of light penetration due to the presence of light-absorbing particles and dissolved molecules (Shigsesada and Okubo, 1981).If Chl tot is the total chlorophyll concentration in the surface layer (of thickness Z 1 ), and Z ML is the mixed-layer depth, the virtual chlorophyll concentration distributed across the mixed layer is given by The combined light-attenuation coefficient attributable to both water and the virtual chlorophyll concentration is given by For a given level of photosynthetically available radiation at the ocean surface (I 0 ), plankton in the surface grid box experience the average irradiance within the mixed layer, which is given by

Predation (including both herbivorous and carnivorous interactions)
Here, we define predation simply as the consumption of any living organism, regardless of the trophic level of the organism (i.e.phytoplankton or zooplankton prey).
The predator-biomass-specific grazing rate of predator (j pred ) on prey (j prey ) is given by overall grazing rate (18) , where γ T is the temperature dependence, G max j pred ,C is the maximum grazing rate, and k j prey ,C is the half-saturation concentration for all (available) prey.The overall grazing rate is a function of total food available to the predator, F j pred ,C .This is given by the product of the prey biomass vector, B C , and the grazing kernel (φ): www.geosci-model-dev.net/11/4241/2018/Geosci.Model Dev., 11, 4241-4267, 2018 Note that this equation is written out in matrix form, with the dimensions noted underneath each matrix.Each element of the grazing matrix φ is an approximately log-normal function of the predator-prey length ratio, ϑ j pred ,j prey , with an optimum ratio of ϑ opt and a geometric standard deviation σ j pred .
φ j pred ,j prey = exp − ln ϑ j pred ,j prey We also include an optional "prey-switching" term, such that predators may preferentially attack those prey that are relatively more available (i.e.active switching, s = 2).Alternatively, they may attack prey in direct proportion to their availability (i.e.passive switching, s = 1).In the simulations below, we assume active switching.
j pred ,j prey = (φ j pred ,j prey B j prey ,C ) s J j prey =1 (φ j pred ,j prey B j prey ,C ) s Finally, a prey refuge function is incorporated, such that the overall grazing rate is decreased when the availability of all prey (F j pred ,C ) is low.The size of the prey refuge is dictated by the coefficient .The overall grazing response is calculated on the basis of prey carbon.Grazing losses of other prey elements are simply calculated from their stoichiometric ratio to prey carbon, with different elements assimilated according to the predator's nutritional requirements (see below):

Prey assimilation
Prey biomass is assimilated into predator biomass with an efficiency of λ j pred ,i b (i b = Chl).This has a maximum value of λ max that is modified according the quota status of the predator.For elements i b = P or Fe, prey biomass is assimilated as a function of the respective predator quota.If the quota is full, the element is not assimilated.If the quota is empty, the element is assimilated with maximum efficiency (λ max ).
C assimilation is regulated according to the status of the most limiting nutrient element (P or Fe) modified by the same shape parameter, h, that was applied in Eq. ( 6).
If both nutrient quotas are full, C is assimilated at the maximum rate.If either is empty, C assimilation is downregulated until sufficient quantities of the limiting element(s) are acquired.

Death
All living biomass is subject to a linear mortality rate of m p .This rate is decreased at very low biomasses (population carbon biomass 10 −10 mmol C m −3 ) in order to maintain a viable population within every surface grid cell ("everything is everywhere, but the environment selects"; Baas-Becking, 1934).
The low biomass at which a population attains "immortality" is sufficiently small for that population to have a negligible impact on all other components of the ecosystem.

Calcium carbonate
The production and export of calcium carbonate (CaCO 3 ) by calcifying plankton in the surface ocean is scaled to the export of particulate organic carbon via a spatially uniform value which is modified by a thermodynamically based relationship with the calcite saturation state.The dissolution of CaCO 3 below the surface is treated in a similar way to that of particulate organic matter (POM; Eq. 34), as described by Ridgwell et al. (2007a) with the parameter values controlling the export ratio between CaCO 3 and particulate organic carbon (POC) taken from Ridgwell et al. (2007b).

Oxygen
Oxygen production is coupled to photosynthetic carbon fixation via a fixed linear ratio, such that The negative sign indicates that oxygen is produced as dissolved inorganic carbon (DIC) is consumed.Oxygen consumption associated with the remineralisation of organic matter is unchanged relative to BIOGEM.

Alkalinity
Production of alkalinity is coupled to planktonic uptake of PO 4 via a fixed linear ratio, such that The negative sign indicates that alkalinity increases as PO 4 is consumed.This relationship accounts for alkalinity changes associated with N transformations (Zeebe and Wolf-Gladrow, 2001) that are not explicitly represented in the biogeochemical configurations of cGEnIE that are applied here.

Production of organic matter
Plankton mortality and grazing are the only two sources of organic matter, with partitioning between non-sinking dissolved and sinking particulate phases determined by the parameter β.In this initial implementation of ECOGEM, we use a similar size-based sigmoidal partitioning function to Ward and Follows (2016).
Here, β a is the (maximum) fraction to DOM as ESD approaches zero, β b is the (minimum) fraction to DOM as ESD approaches infinity, and β c is the size at which the partitioning is 50 : 50 between DOM and POM.The parameter values have been adjusted from Ward and Follows (2016), such that the global average of β is equal to the constant value of 0.66 used in cGEnIE.

Differential equations
Differential equations for R, B, and D are written below.The dimensions of each matrix and vector used in Eqs. ( 30)-( 32) are given in Table 1.Note that while R and OM are transported by the physical component of GEnIE, living biomass B is not currently subject to any physical transport.The only communication between biological communities in adjacent grid cells is through the advection and diffusion of inorganic resources and non-living organic matter in BIOGEM.Note that some additional sources and sinks of R, and all sinks of D, are computed in BIOGEM.

Inorganic resources
For each inorganic resource, i r , uptake . (30)

Plankton biomass
For each plankton class, j , and internal biomass quota, i b , grazing losses .

Dissolved organic matter
For each detrital nutrient element, i d , the rate of change of dissolved fraction of organic matter (k = 1) is described by β j prey G j pred ,j prey ,i d messy feeding .
The dissolved organic matter vector (D 1 ) includes three explicit tracers that are transported by the ocean circulation model and are degraded back to their constituent nutrients with a fixed turnover time of λ(= 0.5 years).POM is not represented with explicit state variables in either ECOGEM or BIOGEM.Instead, its implicit production in the surface layer (and the corresponding export below the surface layer) is given by (1 − β j prey )G j pred ,j prey ,i d messy feeding .This surface production is redistributed throughout the water column as a depth-dependent flux, F z,i d .To achieve this, F surface,i d is partitioned between a "refractory" component r POM that is predominantly remineralised close to the seafloor, and a "labile" component 1 − r POM which predominantly remineralises in the upper water column.The net remineralisation at depth z, relative to the export depth z 0 , is determined by characteristic length scales (l rPOM and l POM for refractory and labile POM, respectively): The remineralisation length scales reflect a constant sinking speed and constant remineralisation rate.All POM reaching the seafloor is remineralised instantaneously; see Ridgwell et al. (2007a) for a fuller description and justification.

Coupling to BIOGEM
The for each BIOGEM time step, i.e. 960 time steps per year).At the beginning of each ECOGEM time step loop, concentrations of inorganic tracers and key properties of the physical environment are passed from BIOGEM.The ecological community responds by transforming inorganic compounds into living biomass through photosynthesis.At the end of each ECOGEM time step loop, the rates of change in R and OM are passed back to BIOGEM.∂R/∂t is used to update DIC, phosphate, iron, oxygen, and alkalinity tracers, while ∂D 1 /∂t is added to the dissolved organic matter pools.The rate of particulate organic matter production, ∂D 2 /∂t, is instantly remineralised at depth using to the standard BIOGEM export functions described above (Eq.34).∂B/∂t is used only to update the living biomass concentrations within ECOGEM.
The structure of the coupling is illustrated in Fig. 1.
In the initial implementation of ECOGEM described and evaluated here, the explicit plankton community is held entirely within the ECOGEM module and is not subject to physical transport (e.g.advection and diffusion) by the ocean circulation model (although dissolved tracers such as nutrients still are).As a first approximation, this approach appears to be acceptable, as long as the rate of transport between the very large grid cells in cGEnIE is slow in relation to the net growth rates of the plankton community.Online advection of ecosystem state variables will be implemented and its consequences explored in a future version of EcoGEnIE.

Ecophysiological parameterisation
The model community is made up of a number of different plankton populations, with each one described according to the same set of equations, as outlined above.Differences between the populations are specified according to individual parameterisation of the equations.In the following sections, we describe how the members of the plankton community are specified and how their parameters are assigned according to the organism's size and taxonomic group.

Model structure
The plankton community in ECOGEM is designed to be highly configurable.Each population present in the initial community is specified by a single line in an input text file, which describes the organism size and taxonomic group.
In this configuration, we include 16 plankton populations across eight different size classes.These are divided into two PFTs, namely phytoplankton and zooplankton (see Table 2).The eight phytoplankton populations have nutrient uptake and photosynthesis traits enabled, and predation traits disabled, whereas the opposite is true for the eight zooplankton populations.In the future, we expect to bring in a wider range of trait-based functional types, including siliceous plankton (e.g.Follows et al., 2007), calcifiers (Monteiro et al., 2016), nitrogen fixers (Monteiro et al., 2010), and mixotrophs (Ward and Follows, 2016).

Size-dependent traits
With the exception of the maximum photosynthetic rate (P max C ; see below), the size-dependent ecophysiological parameters (p) given in Table 3 are assigned as power-law functions of organismal volume (V = π [ESD] 3 /6) according to standard equations of the form Here, V 0 is a reference value of V 0 = 1 µm 3 .The value of p at V = V 0 is given by the coefficient a, while the rate of change in p as a function of V is described by the exponent b.
The maximum photosynthetic rate (P max C ) of very small cells (i.e. 5 µm ESD) has been shown to deviate from the standard power law of Eq. ( 35) (Raven, 1994;Bec et al., 2008;Finkel et al., 2010), so we use the slightly more complex unimodal function given by Ward and Follows (2016).
The parameters of this equation (listed in Table 3) were derived empirically from the data of Marañón et al. (2013).

Size-independent traits
A list of size-independent model parameters is given in Table 4.

Parameter modifications
As far as possible, the parameter values applied in ECOGEM were kept as close as possible to previously published ver-Geosci.Model Dev., 11, 4241-4267, 2018 www.geosci-model-dev.net/11/4241/2018/sions of the model (Ward and Follows, 2016).There were however a few modifications that were required to bring Eco-GEnIE into first-order agreement with observations and the current version of cGEnIE (Ridgwell and Death, 2018).In particular, in comparison to the biogeochemical model used in Ward and Follows (2016), the amount of soluble iron supplied to cGEnIE by atmospheric deposition is considerably less.With a smaller source of iron, it was necessary to decrease the iron demand of the plankton community, and this was achieved by decreasing Q max Fe and Q min Fe by 5-fold (Q max Fe from 20 to 4 nmol Fe (mmol C) −1 , and Q min Fe from 5 to 1 nmol Fe (mmol C) −1 ).
We also found that the flexible stoichiometry of ECO-GEM led to excessive export of carbon from the surface ocean, attributable to higher C : P ratios in organic matter (BIOGEM assumes a Redfieldian C : P of 106).This effect was moderated by increasing the size of the minimum phosphate : carbon quota, Q min P (relative to Ward et al., 2012).
4 Simulations and data 4.1 10 000-year spin-up We ran cGEnIE (as configured and described in Ridgwell and Death, 2018) and EcoGEnIE (as described here) each for period of 10 000 years.These runs were initialised from a homogenous and static ocean, with an imposed constant atmospheric CO 2 concentration of 278 ppm.We present model output from the 10 000th year of integration.

Observations
Although they are not necessarily strictly comparable, we compare results from the pre-industrial configurations of Depth-integrated primary production is from Behrenfeld and Falkowski (1997).All of these interpolated global fields have been re-gridded onto the cGEnIE 36 × 36 × 16 grid.
Observed dissolved iron concentrations are those published by Tagliabue et al. (2012).These data are too sparse and variable to allow reliable mapping on the cGEnIE grid and are therefore shown as individual data.
Fidelity to the observed seasonal cycle of nutrients and biomass was evaluated against observations from nine Joint Global Ocean Flux Study (JGOFS) sites: the Hawai'i ocean Time-series (HOT: 23   the mixed layer.Observational data from all years are plotted together as one climatological year.

Biogeochemical variables
We start by describing the global distributions of key biogeochemical tracers that are common to both cGEnIE and EcoGEnIE.

Global surface values
Annual mean global distributions are presented for the upper 80.8 m of the water column, corresponding to the model surface layer.In Fig. 2, we compare output from the two models to observations of dissolved phosphate and iron.Surface phosphate concentrations are broadly similar between the two versions of the model, except that EcoGEnIE provides slightly lower estimates in the Southern Ocean and equatorial upwellings.Both versions strongly underestimate surface phosphate in the equatorial and north Pacific, and to a lesser extent in the north and east Atlantic, the Arctic, and the Arabian Sea.This is likely attributable in part to the model underestimating the strength of upwelling in these regions.It should also be noted that the observations may in some cases be unrepresentative of the true surface layer, when this is significantly shallower than 80.8 m.In such cases, the observed value will be affected by measurements from below the surface layer.Iron distributions are also broadly similar between the two models, with EcoGEnIE showing slightly lower iron concentrations over most of the ocean.Figure 3 shows observed and modelled values of inorganic carbon, oxygen, and alkalinity.The two models yield very similar surface distributions of the three tracers.DIC and alkalinity are both broadly underestimated relative to observations, while oxygen shows higher fidelity, albeit with artificially high estimates in the equatorial Atlantic and Pacific.This is likely attributable to unrealistically weak upwelling in these regions.
Surface pCO 2 from the two models is shown in Fig. 4. EcoGEnIE shows weaker CO 2 outgassing in the tropical band, with a much stronger ocean-to-atmosphere flux in the western Arctic.
In Fig. 5, we show the annual mean rate of particulate organic matter production in the surface layer, and the relative    Geosci.Model Dev., 11, 4241-4267, 2018 www.geosci-model-dev.net/11/4241/2018/ the stoichiometry of biological production.In cGEnIE (BIO-GEM), carbon and phosphorus production is rigidly coupled through a fixed ratio of 106 : 1, while POFe : POC and CaCO 3 POC export flux ratios are regulated as a function of environmental conditions.In EcoGEnIE (ECOGEM), phosphorus, iron, and carbon fluxes are all decoupled through the flexible quota physiology, which depends on both environmental conditions and the status of the food web.Only CaCO 3 : POC flux ratios are regulated via the same mechanism in the two models.

Basin-averaged depth profiles
In this section, we present the meridional depth distributions of key biogeochemical tracers, averaged across each of the three main ocean basins, as shown in Fig. 6. Figure 7 shows that the distribution of dissolved phosphate is very similar between the two models, with EcoGEnIE showing a slightly stronger subsurface accumulation in the northern Indian Ocean.
The vertical distributions shown in Fig. 8 reveal that dissolved iron is lower throughout the ocean in EcoGEnIE, relative to cGEnIE, particularly below 1500 m.Differences are less obvious at intermediate depths.(Observations are currently too sparse to estimate reliable basin-scale distributions of dissolved iron; see Tagliabue et al., 2016.) Figure 9 shows that while cGEnIE reproduces observed DIC distributions very well, EcoGEnIE overestimates concentrations within the Indian and Pacific oceans.The total oceanic DIC inventory increased by just under 2 % from 2.99 Examole C in cGEnIE to 3.05 in EcoGEnIE (with a fixed atmospheric CO 2 concentration of 278 ppm).Otherwise, the two models show broadly similar distributions, with the most pronounced differences (as for PO 4 ) in the northern Indian Ocean.
Figure 10 shows that cGEnIE reasonably captures the invasion of O 2 into the ocean interior through the Southern Ocean and North Atlantic.These patterns are also seen in EcoGEnIE, although unrealistic water column anoxia is seen in the northern intermediate Indian and Pacific oceans.Again, this is likely a consequence of greater export and remineralisation of organic carbon in EcoGEnIE, leading to more oxygen consumption at intermediate depths (also evidenced by elevated PO 4 , DIC, and alkalinity in the same regions; Figs. 7,9,and 11).
Alkalinity (Fig. 11) also shows some clear differences between the two models, again most noticeably in the northern intermediate Indian and Pacific oceans.In these regions, EcoGEnIE shows excessive accumulation of alkalinity at ∼ 1000 m depth.This is again attributable to the increased C export in EcoGEnIE.In the absence of a nitrogen cycle (and NO − 3 reduction), increased anoxic remineralisation of organic carbon (Figs. 9 and 10) leads to increased reduction of sulfate to H 2 S, which in turn increases the alkalinity of seawater.Further adjustment of the cellular nutrient quotas in ECOGEM and hence the effective exported P : C Redfield ratio and/or retuning of the organic matter remineralisation profiles in BIOGEM (Ridgwell et al., 2007a) would likely resolve these issues.

Time series
Figures 12 and 13 compare the seasonal cycles of surface nutrients (phosphate and iron) at nine Joint Global Ocean Flux Study (JGOFS) sites.

Ecological variables
Moving on from the core components that are common to both models, we present a range of ecological variables that are exclusive to EcoGEnIE.As before, we begin by presenting the annual mean global distributions in the ocean surface layer, comparing total chlorophyll and primary production to satellite-derived estimates (Fig. 14).We then look in more detail at the community composition, with Fig. 15 showing the carbon biomass within each plankton population.Figure 16 then shows the degree of nutrient limitation within each phytoplankton population.Finally, in Fig. 17, we show the seasonal cycle of community and population level chlorophyll at each of the nine JGOFS time series sites.

Global surface values
Figure 14 reveals that EcoGEnIE shows some limited agreement with the satellite-derived estimate of global chlorophyll.As expected, chlorophyll biomass is elevated in the high-latitude oceans relative to lower latitudes.The subtropical gyres show low biomass, but the distinction with higher latitudes is not as clear as in the satellite estimate.The model also shows a clear lack of chlorophyll in equatorial and coastal upwelling regions, relative to the satellite estimate.The model predicts higher chlorophyll concentrations in the Southern Ocean than the satellite estimate, although it should be noted that the satellite algorithms may be underestimating concentrations in these regions (Fig. 17 and Dierssen, 2010).
Modelled primary production correctly increases from the oligotrophic gyres towards high latitudes and upwelling regions, but variability is much lower than in the satellite es-    timate.Specifically, the model and satellite estimates yield broadly similar estimates in the oligotrophic gyres, but the model does not attain the high values seen at higher latitudes and in coastal areas.
Figure 15 shows the modelled carbon biomass concentrations in the surface layer for each modelled plankton population.The smallest (0.6 µm) phytoplankton size class is evenly distributed in the low-latitude oceans between 40 • N and S but is largely absent nearer to the poles.The 1.9 µm  ).The satellite-derived estimate of primary production is a composite of three products (Behrenfeld and Falkowski, 1997;Carr et al., 2006;Westberry et al., 2008), as in Yool et al. (2013, their  phytoplankton size class is similarly ubiquitous at low latitudes, albeit with somewhat higher biomass, and its range extends much further towards the poles.With increasing size, the larger phytoplankton are increasingly restricted to highly productive areas, such as the subpolar gyres and upwelling zones.Perhaps as expected, zooplankton size classes tend to mirror the biogeography of their phytoplankton prey.The smallest (1.9 µm) surviving size class is found primarily at low latitudes, although a highly variable population is found at higher latitudes.Larger zooplankton size classes follow a similar pattern to the phytoplankton, moving from a cosmopolitan but homogenous distribution in the smaller size classes towards spatially more variable distributions among the larger organisms.
The degree of nutrient limitation within each phytoplankton size class is shown in Fig. 16.The two-dimensional colour scale indicates decreasing iron limitation from left to right, and decreasing phosphorus limitation from bottom to top.White is therefore nutrient replete, blue is phosphorus limited, red is iron limited, and magenta is phosphorus-iron co-limited.The figure demonstrates that the smallest size class is not nutrient limited in any region.The increasing saturation of the colour scale in larger size classes indicates an increasing degree of nutrient limitation.As expected, nutrient limitation is strongest in the highly stratified low latitudes.A stronger vertical supply of nutrients at higher latitudes is associated with weaker nutrient limitation, although nutrient limitation is still significant among the larger size classes.Consistent with observations (Moore et al., 2013), phosphorus limitation is restricted to low latitudes.Iron limitation dominates in high-latitude regions, especially among larger size classes.Among these larger groups, the upwelling zones appear to be characterised by iron-phosphorus co-limitation.

Time series
The seasonal cycles of phytoplankton chlorophyll a are compared to time series observations in Fig. 17.The modelled total chlorophyll concentrations (black lines) track the observed concentrations (red dots) reasonably well at most sites.The bottom three panels also suggest that the satellite data shown in Fig. 14 may slightly underestimate surface chlorophyll concentrations in the Southern Ocean.The modelled surface chlorophyll concentration is too low in the equatorial Pacific, while the spring bloom occurs 1-2 months earlier than was seen during the North Atlantic Bloom Experiment.
The seasonal cycles of primary production in the surface layer are compared to time series observations in Fig. 18.As also indicated in Fig. 14, the spatial variance in modelled primary production is too low, with primary production overestimated at the most oligotrophic site (HOT) and typically underestimated at the most productive sites (especially the equatorial Pacific, NABE, and the Ross Sea).In contrast to  the lack of spatial variability, the model exhibits significant seasonal variation, often in excess of the observed variability (at those sites where the seasonal cycle is well resolved).

cGEnIE vs. EcoGEnIE
Figure 19 is a Taylor diagram comparing the two models in terms of their correlation to observations and their standard deviations, relative to observations.A perfect model would be located at the middle of the bottom axis, with a correlation coefficient of 1.0 and a normalised standard deviation of 1.0.The closer a model is to this ideal point, the better a representation of the data it provides.Figure 19 shows that EcoGEnIE is located further from the ideal point than cGE-nIE, in terms of oxygen, alkalinity, phosphate, and DIC.The new model seems to provide a universally worse representation of global ocean biogeochemistry.This is perhaps not surprising, given that the BIOGEM component of cGEnIE has at various times been systematically tuned to match the observation data (e.g.Ridgwell et al., 2007a;Ridgwell and Death, 2018).EcoGEnIE has not yet been optimised in this way.

Discussion
The marine ecosystem is a central component of the Earth system, harnessing solar energy to sustain the biogeochemical cycling of elements between dissolved inorganic nutrients, living biomass, and decaying organic matter.The interaction of these components with the global carbon cycle is critical to our interpretation of past, present, and future climates, and has motivated the development of a wide range of models.These can be placed on a spectrum of increasing complexity, from simple and computationally efficient box models to fully coupled Earth system models with extremely large computational costs.cGEnIE is a model of intermediate complexity on this spectrum.It has been designed to allow rapid model evaluation while at the same time retaining somewhat realistic global dynamics that facilitate comparison with observations.With this goal in mind, the biological pump was parameterised as a simple vertical flux defined as a function of environmental conditions (Ridgwell et al., 2007a).This simplicity is well suited to questions concerning the interactions of marine biogeochemistry and climate, but at the same time precludes any investigation of the role of ecological interactions with the broader Earth system.
Here, we have presented an ecological extension to cGE-nIE that opens up this area of investigation.EcoGEnIE is rooted in size-dependent physiological and ecological constraints (Ward et al., 2012).The ecophysiological parameters are relatively well constrained by observations, even in comparison to simpler ecosystem models that are based on much more aggregated functional groups (Anderson, 2005; Litch-    , 2007).The size-based formulation has the additional benefit of linking directly to functional aspects of the ecosystem, such as food web structure and particle sinking (Ward and Follows, 2016).
The aim of this paper is to provide a detailed description of the new ecological component.It is clear from Fig. 19 that the switch from the parameterised biological pump to the explicit ecological model has led to a deterioration in the overall ability of cGEnIE to reproduce the global distributions of important biogeochemical tracers.This is an acceptable outcome, as our goal here is simply to provide a full description of the new model.Given that the original model was calibrated to the observations in question (Ridgwell et al., 2007a), that process will need to be repeated for the new model before any sort of objective comparison can be made.We also note that EcoGEnIE is still capable of reproducing approximately 90 % of the global variability in DIC, more than 70 % for phosphate, oxygen, and alkalinity, and more than 50 % for surface chlorophyll.
Despite a slight overall deterioration in terms of modelobservation misfit, the biogeochemical components of the model retain the key features that should be expected.At the same time, the ecological community conforms to expectations in terms of standing stocks and fluxes, both in terms of large-scale spatial distributions and the seasonal cycles at specific locations (Figs. 14 and 17).Overall patterns of community structure and physiological limitation also follow expectations based on observations and theory.
As presented, the model is limited to three limiting resources (light, phosphorus, and iron) and two plankton func-tional types (phytoplankton and zooplankton).We have written the model equations and code to facilitate the extension of the model to include additional components.In particular, the model capabilities can be extended by enabling silicon and nitrogen limitation, leveraging the silicon and nitrogen cycles already present in BIOGEM (Monteiro et al., 2012).Adding these nutrients will enable the addition of diatoms and diazotrophs, which are both likely to be important factors affecting the long-term strength of the biological pump (Tyrrell, 1999;Armstrong et al., 2002).

Code availability Muffin
A manual, detailing code installation, basic model configuration, plus an extensive series of tutorials covering various aspects of the cGEnIE "muffin" release, experimental design, and results' output and processing, is provided.The Latex source of the manual along with pre-built PDF file can be obtained by cloning (https://github.com/derpycode/muffindoc).

Instructions
The muffin manual contains instructions for obtaining, installing, and testing the code, plus how to run experiments.Specifically, -Section 1.1 provides a basic overview of the software environment required for installing and running muffin.
-Section 1.2.2 provides a basic overview of cloning and testing the code.
-Section 17.4 provides a detailed guide to cloning the code and configuring an Ubuntu (18.04) software environment including netCDF library installation, plus running a basic test.
-Section 17.6 provides a detailed guide to cloning the code and configuring a Mac OS software environment including netCDF library installation, plus running a basic test.
-Section 1.4 provides a basic introduction to model output (much more detail is given in Sect.12).

Figure 1 .
Figure 1.Schematic representation of the coupling between BIO-GEM and ECOGEM.State variables: R indicates the inorganic element (i.e.resource), B indicates plankton biomass, and OM indicates organic matter.Subscripts B and E denote state variables in BIOGEM and ECOGEM, respectively.BIOGEM passes resource biomass R to ECOGEM.ECOGEM passes rates of change (δ) in R and OM back to BIOGEM.
cGEnIE and EcoGEnIE to contemporary climatologies from a range of sources.Global climatologies of dissolved phosphate and oxygen are drawn from the World Ocean Atlas 2009 (WOA09 -Garcia et al., 2010), while DIC and alkalinity are taken from Global Ocean Data Analysis Project version 2 (GLODAPv2 -Olsen, 2016).Surface chlorophyll concentrations represent a climatological average from 1997 to 2002, estimated by the SeaWiFS satellite.

Figure 6 .
Figure 6.Spatial definition of the three ocean basins used in Figs.7-10.Locations of the JGOFS time series sites are indicated with blue dots.

Figure 12 .
Figure 12.Annual cycle of surface PO 4 at nine time series sites in cGEnIE and EcoGEnIE.Red dots indicate climatological observations, while the lines represent modelled surface PO 4 concentrations.Locations of the time series are indicated in Fig. 6.

Figure 13 .
Figure 13.Annual cycle of surface dissolved iron at nine time series sites in cGEnIE and EcoGEnIE.Red dots indicate climatological observations, while the lines represent modelled surface iron concentrations.Locations of the time series are indicated in Fig. 6.

Figure 15 .
Figure 15.Surface concentrations of carbon biomass in each population (mmol C m −3 ).

Figure 16 .
Figure 16.Nutrient limitation in each phytoplankton population (dimensionless).The two-dimensional colour scale indicates decreasing phosphorus limitation from left to right, and decreasing iron limitation from bottom to top.White is therefore nutrient replete, blue is phosphorus limited, red is iron limited, and magenta is phosphorus-iron co-limited.

Figure 17 .
Figure 17.Annual cycle of surface chlorophyll a at nine JGOFS time series sites.Red dots indicate climatological observations, while the black lines represent modelled total surface chlorophyll a. Coloured lines represent chlorophyll a in individual size classes (blue is small; red is large).Locations of the time series are indicated in Fig. 6.Satellite estimates of chlorophyll a are shown in grey.

Figure 18 .
Figure 18.Annual cycle of surface primary production at nine JGOFS time series sites.Red dots indicate climatological observations, while the black lines represent modelled total primary production.Locations of the time series are indicated in Fig. 6.

Table 1 .
State variable index notation.
D is a K × I d matrix, where K is the number of detrital size classes and I d is the number of detrital nutrient elements.

Table 2 .
Plankton functional groups and sizes in the standard run.