New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
Changeset 2255 for branches/DEV_r1826_DOC/DOC/TexFiles/Chapters/Chap_SBC.tex – NEMO

Ignore:
Timestamp:
2010-10-13T15:22:26+02:00 (14 years ago)
Author:
rfurner
Message:

changes to river runoff documentation

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/DEV_r1826_DOC/DOC/TexFiles/Chapters/Chap_SBC.tex

    r2242 r2255  
    1 % ================================================================ 
     1 ================================================================ 
    22% Chapter Ñ Surface Boundary Condition (SBC)  
    33% ================================================================ 
     
    363363%------------------------------------------------------------------------------------------------------------- 
    364364 
    365 River runoff generally enters the ocean at a nonzero depth rather than through the surface.  
     365%River runoff generally enters the ocean at a nonzero depth rather than through the surface.  
     366%Many models, however, have traditionally inserted river runoff to the top model cell. 
     367%This was the case in \NEMO prior to the version 3.3. The switch toward a input of runoff  
     368%throughout a nonzero depth has been motivated by the numerical and physical problems  
     369%that arise when the top grid cells are of the order of one meter. This situation is common in  
     370%coastal modelling and becomes more and more often open ocean and climate modelling  
     371%\footnote{At least a top cells thickness of 1~meter and a 3 hours forcing frequency are 
     372%required to properly represent the diurnal cycle \citep{Bernie_al_JC05}. see also \S\ref{SBC_dcy}.}. 
     373 
     374 
     375%To do this we need to treat evaporation/precipitation fluxes and river runoff differently in the  
     376%\mdl{tra\_sbc} module.  We decided to separate them throughout the code, so that the variable  
     377%\textit{emp} represented solely evaporation minus precipitation fluxes, and a new 2d variable  
     378%rnf was added which represents the volume flux of river runoff (in kg/m2s to remain consistent with  
     379%emp).  This meant many uses of emp and emps needed to be changed, a list of all modules which use  
     380%emp or emps and the changes made are below: 
     381 
     382 
     383%Rachel: 
     384River runoff generally enters the ocean at a nonzero depth rather than through the surface. 
    366385Many models, however, have traditionally inserted river runoff to the top model cell. 
    367 This was the case in \NEMO prior to the version 3.3. The switch toward a input of runoff  
    368 throughout a nonzero depth has been motivated by the numerical and physical problems  
    369 that arise when the top grid cells are of the order of one meter. This situation is common in  
    370 coastal modelling and becomes more and more often open ocean and climate modelling  
     386This was the case in \NEMO prior to the version 3.3, and was combined with an option to increase vertical mixing near the river mouth. 
     387 
     388However, with this method numerical and physical problems arise when the top grid cells are  
     389of the order of one meter. This situation is common in coastal modelling and is becoming  
     390more common in open ocean and climate modelling  
    371391\footnote{At least a top cells thickness of 1~meter and a 3 hours forcing frequency are 
    372392required to properly represent the diurnal cycle \citep{Bernie_al_JC05}. see also \S\ref{SBC_dcy}.}. 
    373393 
    374  
    375 To do this we need to treat evaporation/precipitation fluxes and river runoff differently in the \mdl{tra\_sbc} module.  We decided to separate them throughout the code, so that the variable \textit{emp} represented solely evaporation minus precipitation fluxes, and a new 2d variable rnf was added which represents the volume flux of river runoff (in kg/m2s to remain consistent with emp).  This meant many uses of emp and emps needed to be changed, a list of all modules which use emp or emps and the changes made are below: 
    376  
    377  
    378 Rachel: 
    379  
    380 It is convenient to introduce the river runoff in the model as a surface  
    381 fresh water flux. This is the default option within NEMO, and there is then 
    382  the option for the user to increase vertical mixing in the vicinity of the rivermouth. 
    383  
    384 However, this method is not very appropriate for coastal modelling.  As such its now possible  
    385 to specify, in a NetCDF input file, the temperature and salinity of the river, along with the  
    386 depth (in metres) which the river should be added to.  This enables to river to be correctly  
    387 added through the water column, instead of as a surface flux, and also means the temperature  
    388 or salinity (for low salinity outflow) of the river impacts the surrounding ocean. 
    389  
    390 For temperature -999 is taken as missing data and the river temperature is taken to be the  
    391 surface temperatue at the river point.  For the depth parameter a value of -1 means the  
    392 river is added to the surface box only, and a value of -999 means the river is added through  
    393 the entire water column. 
     394As such from VN3.3 onwards it is possible to add river runoff through a non-zero depth, and for the  
     395temperature and salinity of the river to effect the surrounding ocean. 
     396The user is able to specify, in a NetCDF input file, the temperature and salinity of the river, along with the    
     397depth (in metres) which the river should be added to. 
    394398 
    395399Namelist options, \np{ln\_rnf\_depth}, \np{ln\_rnf\_sal} and \np{ln\_rnf\_temp} control whether  
     
    398402taken as surface temperature respectively. 
    399403 
    400 It is also possible for runnoff to be specified as a negative value for modelling flow through  
    401 straits, i.e. modelling the baltic flow in and out of the North Sea.  When the flow is out of the  
    402 domain there is no change in temperature and salinity, regardless of the namelist options used. 
    403  
    404 The runoff value and attributes are read in in sbcrnf.  The mass/volume addition is added to the  
    405 divergence term in \rou{sbc\_rnf\_div}.  The dilution effect of the river is automatically applied through  
    406 the vertical tracer advection, and the direct flux of tracers into the domain is done in trasbc. 
    407  
    408  
    409 \colorbox{yellow}{Nevertheless, Pb of vertical resolution and 3D input : increase vertical mixing near river mouths to mimic a 3D river  
    410  
    411 All river runoff and emp fluxes are assumed to be fresh water (zero salinity) and at the same temperature as the sea surface.} 
    412  
    413 \colorbox{yellow}{river mouths{\ldots}} 
     404The runoff value and attributes are read in in sbcrnf.   
     405For temperature -999 is taken as missing data and the river temperature is taken to be the  
     406surface temperatue at the river point. 
     407For the depth parameter a value of -1 means the river is added to the surface box only,  
     408and a value of -999 means the river is added through the entire water column.  
     409After being read in the temperature and salinity variables are multiplied by the amount of runoff (converted into m/s)  
     410to give the heat and salt content of the river runoff. 
     411After the user specified depth is read ini, the number of grid boxes this corresponds to is  
     412calculated and stored in the variable \np{nz\_rnf}. 
     413The variable \np{h\_dep} is then calculated to be the depth (in metres) of the bottom of the  
     414lowest box the river water is being added to (i.e. the total depth that river water is being added to in the model). 
     415 
     416The mass/volume addition due to the river runoff is, at each relevant depth level, added to the horizontal divergence (\np{hdivn})  
     417in the subroutine \np{sbc\_rnf\_div} (called from \np{divcur}). 
     418This increases the diffusion term in the vicinity of the river, thereby simulating a momentum flux. 
     419The sea surface height is calculated using the sum of the horizontal divergence terms, and so the  
     420river runoff indirectly forces an increase in sea surface height.  
     421 
     422The \np{hdivn} terms are used in the tracer advection modules to force vertical velocities. 
     423This causes a mass of water, equal to the amount of runoff, to be moved into the box above.  
     424The heat and salt content of the river runoff is not included in this step, and so the tracer  
     425concentrations are diluted as water of ocean temperature and salinity is moved upward out of the box  
     426and replaced by the same volume of river water with no corresponding heat and salt addition. 
     427 
     428For the linear free surface case, at the surface box the tracer advection causes a flux of water  
     429(of equal volume to the runoff) through the sea surface out of the domain, which causes a salt and heat flux out of the model. 
     430As such the volume of water does not change, but the water is diluted. 
     431 
     432For the non-linear free surface case (vvl), no flux is allowed through the surface. 
     433Instead in the surface box (as well as water moving up from the boxes below) a volume of runoff water  
     434is added with no corresponding heat and salt addition and so as happens in the lower boxes there is a dilution effect. 
     435(The runoff addition to the top box along with the water being moved up through boxes below means the surface box has a large  
     436increase in volume, whilst all other boxes remain the same size) 
     437 
     438In trasbc the addition of heat and salt due to the river runoff is added. 
     439This is done in the same way for both vvl and non-vvl. 
     440The temperature and salinity are increased through the specified depth according to the heat and salt content of the river.  
     441 
     442In the non-linear free surface case (vvl), near the end of the time step the change in sea surface height is redistrubuted  
     443through the grid boxes, so that the original ratios of grid box heights are restored. 
     444In doing this water is moved into boxes below, throughout the water column, so the large volume addition to the surface box is spread between all the grid boxes. 
     445 
     446It is also possible for runnoff to be specified as a negative value for modelling flow through straits, i.e. modelling the Baltic flow in and out of the North Sea. 
     447When the flow is out of the domain there is no change in temperature and salinity, regardless of the namelist options used, as the ocean water leaving the domain removes heat and salt (at the same concentration) with it.  
     448 
     449 
     450%\colorbox{yellow}{Nevertheless, Pb of vertical resolution and 3D input : increase vertical mixing near river mouths to mimic a 3D river  
     451 
     452%All river runoff and emp fluxes are assumed to be fresh water (zero salinity) and at the same temperature as the sea surface.} 
     453 
     454%\colorbox{yellow}{river mouths{\ldots}} 
    414455 
    415456%IF( ln_rnf ) THEN                                     ! increase diffusivity at rivers mouths 
     
    417458%ENDIF 
    418459 
    419 \gmcomment{  word doc of runoffs: 
    420  
    421 In the current \NEMO setup river runoff is added to emp fluxes, these are then applied at just the sea surface as a volume change (in the variable volume case this is a literal volume change, and in the linear free surface case the free surface is moved) and a salt flux due to the concentration/dilution effect.  There is also an option to increase vertical mixing near river mouths; this gives the effect of having a 3d river.  All river runoff and emp fluxes are assumed to be fresh water (zero salinity) and at the same temperature as the sea surface. 
    422 Our aim was to code the option to specify the temperature and salinity of river runoff, (as well as the amount), along with the depth that the river water will affect.  This would make it possible to model low salinity outflow, such as the Baltic, and would allow the ocean temperature to be affected by river runoff.   
    423  
    424 The depth option makes it possible to have the river water affecting just the surface layer, throughout depth, or some specified point in between. 
    425  
    426 To do this we need to treat evaporation/precipitation fluxes and river runoff differently in the tra_sbc module.  We decided to separate them throughout the code, so that the variable emp represented solely evaporation minus precipitation fluxes, and a new 2d variable rnf was added which represents the volume flux of river runoff (in kg/m2s to remain consistent with emp).  This meant many uses of emp and emps needed to be changed, a list of all modules which use emp or emps and the changes made are below: 
     460%\gmcomment{  word doc of runoffs: 
     461% 
     462%In the current \NEMO setup river runoff is added to emp fluxes, these are then applied at just the sea surface as a volume change (in the variable volume case this is a literal volume change, and in the linear free surface case the free surface is moved) and a salt flux due to the concentration/dilution effect.  There is also an option to increase vertical mixing near river mouths; this gives the effect of having a 3d river.  All river runoff and emp fluxes are assumed to be fresh water (zero salinity) and at the same temperature as the sea surface. 
     463%Our aim was to code the option to specify the temperature and salinity of river runoff, (as well as the amount), along with the depth that the river water will affect.  This would make it possible to model low salinity outflow, such as the Baltic, and would allow the ocean temperature to be affected by river runoff.   
     464 
     465%The depth option makes it possible to have the river water affecting just the surface layer, throughout depth, or some specified point in between. 
     466 
     467%To do this we need to treat evaporation/precipitation fluxes and river runoff differently in the tra_sbc module.  We decided to separate them throughout the code, so that the variable emp represented solely evaporation minus precipitation fluxes, and a new 2d variable rnf was added which represents the volume flux of river runoff (in kg/m2s to remain consistent with emp).  This meant many uses of emp and emps needed to be changed, a list of all modules which use emp or emps and the changes made are below: 
    427468 
    428469} 
Note: See TracChangeset for help on using the changeset viewer.