= Wave-aware bulk formula parameterizations =

Last edition: '''[[Wikinfo(changed_ts)]]''' by '''[[Wikinfo(changed_by)]]'''

The PI is responsible to closely follow the progress of the action, and especially to contact NEMO project manager if the delay on preview (or review) are longer than the 2 weeks expected.

[[PageOutline(2, , inline)]]

== Summary ==

See ticket #2158 [https://forge.ipsl.jussieu.fr/nemo/ticket/2158]


||=Action'''    || Wave-aware bulk formula parameterizations   ||
||=PI(S)'''     || Laurent Brodeau @ Ocean Next ||
{{{#!th style='text-align: left'
Digest
}}}
{{{#!td
Improvement of bulk closures and parameterizations for more accurate estimate of bulk exchange coefficients, through the use of the relevant surface wave information.
In other words, the bulk parameterizations already included in NEMO/SBC, such as COARE or ECMWF, will have the possibility to deduce a more accurate roughness length (z0) of the sea-surface based on wave information originating either from the wave model (in the coupled case), or from a monthly climatology.

}}}
|-
||=Dependencies || #2159                                                                    ||
||=Expected for || ?                                              ||
||=Ticket       || #2158                                                                 ||
||=Branch       || none yet           ||
||=Previewer(s) ||                                                                       ||
||=Reviewer(s)  ||                                                                       ||
||=Link         || [[ExtractUrl(.)]]                                                     ||



=== Description ===

* Implement the possibility for the various turbulent bulk parametrizations to use the local/actual wave information, for more accurate estimation of the sea-surface roughness within the closure.
 * Mainly in ECMWF and COARE 3.6 algorithms (see [https://forge.ipsl.jussieu.fr/nemo/wiki/2019WP/ASINTER-05_Brodeau_Advanced_Bulk], ticket #2159)


=== Implementation ===

{{{#!box width=35em help
Describe flow chart of the changes in the code. \\
List the Fortran modules and subroutines to be created/edited/deleted. \\
Detailed list of new variables to be defined (including namelists), \\
give for each the chosen name and description wrt coding rules.
}}}

''...''

=== Documentation updates ===

{{{#!box width=55em help
Using previous parts, define the main changes to be done in the NEMO literature 
(manuals, guide, web pages, …).
}}}

''...''

== Preview 

{{{#!box width=50em info
[[Include(wiki:Developers/DevProcess#preview_)]]
}}}

''...''

== Tests

{{{#!box width=50em info
[[Include(wiki:Developers/DevProcess#tests)]]
}}}


Test-case associated with this development:

	• Test case name: '''STATION_ASF''' (C1D meets SAS). See [https://github.com/NEMO-ocean/NEMO-examples/tree/master/STATION_ASF] for a more complete introduction.

	• Test case functionality: test-case STATION_ASF checks that all bulk algorithms available in NEMO, used to estimate the bulk transfer coefficient for turbulent air-sea and air-ice fluxes, are working properly. This is done by checking that all turbulent fluxes computed at the punctual location of STATION_ASF lie within a reasonable range.


	• Test case setup: in STATION_ASF nemo.exe runs on one processor and needs only 2 lightweight netCDF files as input. These 2 files provide hourly time-series of sea-surface variables (SST, SSH), and surface atmospheric state (wind, temperature, humidity and downwelling radiative fluxes), respectively, at the punctual location of STATION_ASF. 1 year of simulation with STATION_ASF takes a few tens of seconds on 1 proc.

	• Test case verification value: WILL BE boolean. Each computed turbulent flux (hourly time-series), namely evaporation, wind stress and sensible flux, will be checked for consistency during a whole year. This operation will be carried out with every bulk (air-sea and air-ice) parameterization algorithms available in NEMO, including the testing of different options: cool-skin/warm-layer and wave-pattern input).


	• Status of the test case as for now: Exists on the official GitHub for NEMO. Boolean output not ready yet, version for air-ice fluxes in progress. 







== Review

{{{#!box width=50em info
[[Include(wiki:Developers/DevProcess#review)]]
}}}

''...''