Changeset 12377 for NEMO/trunk/doc/latex
- Timestamp:
- 2020-02-12T15:39:06+01:00 (4 years ago)
- Location:
- NEMO/trunk
- Files:
-
- 6 deleted
- 22 edited
- 20 copied
Legend:
- Unmodified
- Added
- Removed
-
NEMO/trunk
- Property svn:externals
-
old new 3 3 ^/utils/build/mk@HEAD mk 4 4 ^/utils/tools@HEAD tools 5 ^/vendors/AGRIF/dev @HEAD ext/AGRIF5 ^/vendors/AGRIF/dev_r11615_ENHANCE-04_namelists_as_internalfiles_agrif@HEAD ext/AGRIF 6 6 ^/vendors/FCM@HEAD ext/FCM 7 7 ^/vendors/IOIPSL@HEAD ext/IOIPSL
-
- Property svn:externals
-
NEMO/trunk/doc/latex/.svnignore
r11593 r12377 8 8 *.ilg 9 9 *.ind 10 *.lo* 10 *.lof 11 *.log 12 *.lot 11 13 *.maf 12 14 *.mtc* … … 14 16 *.pdf 15 17 *.toc 16 *.xdv17 18 _minted-* -
NEMO/trunk/doc/latex/NEMO/build
- Property svn:ignore
-
old new 14 14 *.pdf 15 15 *.toc 16 *.xdv17 16 _minted-*
-
- Property svn:ignore
-
NEMO/trunk/doc/latex/NEMO/main/appendices.tex
r11567 r12377 1 1 2 \subfile{../subfiles/a pdx_s_coord} %% A.Generalised vertical coordinate3 \subfile{../subfiles/a pdx_diff_opers} %% B. Diffusive operators4 \subfile{../subfiles/a pdx_invariants} %% C.Discrete invariants of the eqs.5 \subfile{../subfiles/a pdx_triads} %% D.Isoneutral diffusion using triads6 \subfile{../subfiles/a pdx_DOMAINcfg} %% E. Brief notes on DOMAINcfg2 \subfile{../subfiles/annex_A} %% Generalised vertical coordinate 3 \subfile{../subfiles/annex_B} %% Diffusive operator 4 \subfile{../subfiles/annex_C} %% Discrete invariants of the eqs. 5 \subfile{../subfiles/annex_iso} %% Isoneutral diffusion using triads 6 \subfile{../subfiles/annex_D} %% Coding rules 7 7 8 8 %% Not included … … 10 10 %\subfile{../subfiles/chap_DIU} 11 11 %\subfile{../subfiles/chap_conservation} 12 %\subfile{../subfiles/apdx_algos} %% Notes on some on going staff 12 %\subfile{../subfiles/annex_E} %% Notes on some on going staff 13 -
NEMO/trunk/doc/latex/NEMO/main/bibliography.bib
r11674 r12377 400 400 } 401 401 402 @article{ brodeau.barnier.ea_JPO1 6,403 title = "Climatologically Significant Effects of Some Approximations in the Bulk Parameterizations of Turbulent Air –Sea Fluxes",402 @article{ brodeau.barnier.ea_JPO17, 403 title = "Climatologically Significant Effects of Some Approximations in the Bulk Parameterizations of Turbulent Air{\textendash}Sea Fluxes", 404 404 pages = "5--28", 405 405 journal = "Journal of Physical Oceanography", … … 407 407 number = "1", 408 408 author = "Brodeau, Laurent and Barnier, Bernard and Gulev, Sergey K. and Woods, Cian", 409 year = "201 6",409 year = "2017", 410 410 month = "jan", 411 411 publisher = "American Meteorological Society", … … 3134 3134 doi = "10.1029/92jc00911" 3135 3135 } 3136 3137 @article{large.yeager_CD09, 3138 author="Large, W. G. and Yeager, S. G.", 3139 title="The Global Climatology of an Interannually Varying Air-Sea Flux Data Set", 3140 pages = "341--364", 3141 journal="Climate Dynamics", 3142 volume = "33", 3143 number = "2-3", 3144 year="2009", 3145 month = "aug", 3146 publisher = "Springer Science and Business Media LLC", 3147 doi="10.1007/s00382-008-0441-3" 3148 } 3149 3150 @book{sverdrup.johnson.ea_1942, 3151 author = {H. U. Sverdrup and Martin W. Johnson and Richard H. Fleming}, 3152 title = {The Oceans, Their Physics, Chemistry, and General Biology}, 3153 publisher = {Prentice-Hall}, 3154 address = {New York}, 3155 year = {1942}, 3156 pages = {1087}, 3157 } 3158 3159 @article{kraus.businger_QJRMS96, 3160 author = "E. B. Kraus and J. A. Businger", 3161 title = "Atmosphere-ocean interaction.", 3162 journal="Quarterly Journal of the Royal Meteorological Society",, 3163 year = "1996", 3164 volume = "122", 3165 number = "529", 3166 pages = "324-325", 3167 publisher = "John Wiley & Sons, Ltd", 3168 issn = "1477-870X", 3169 doi = "10.1002/qj.49712252914" 3170 } 3171 3172 @article{josey.gulev.ea_2013, 3173 title = "Exchanges through the ocean surface", 3174 journal = "Ocean Circulation and Climate - A 21st Century Perspective, Int. Geophys. Ser.", 3175 year = "2013", 3176 author = "S. A. Josey and S. Gulev and L. Yu", 3177 pages = "115-140, edited by G. Siedler et al., Academic Press, Oxford", 3178 volume = "103", 3179 doi = "10.1016/B978-0-12-391851-2.00005-2" 3180 } 3181 3182 @article{fairall.bradley.ea_JGR96, 3183 year = "1996", 3184 journal = "Journal of Geophysical Research: Oceans", 3185 month = "jan", 3186 publisher = "American Geophysical Union", 3187 volume = "101", 3188 number = "C1", 3189 pages = "1295-1308", 3190 author = "C. W. Fairall and E. F. Bradley and J. S. Godfrey and G. A. Wick and J. B. Edson and G. S. Young", 3191 title = "Cool-skin and warm-layer effects on sea surface temperature", 3192 doi = "10.1029/95jc03190" 3193 } 3194 3195 @article{zeng.beljaars_GRL05, 3196 year = "2005", 3197 month = "jul", 3198 publisher = "American Geophysical Union", 3199 volume = "32", 3200 number = "14", 3201 author = "Xubin Zeng and Anton Beljaars", 3202 title = "A prognostic scheme of sea surface skin temperature for modeling and data assimilation", 3203 journal = "Geophysical Research Letters", 3204 doi = "10.1029/2005gl023030" 3205 } 3206 -
NEMO/trunk/doc/latex/NEMO/main/chapters.tex
r11567 r12377 1 \subfile{../subfiles/chap_model_basics} %% 1. 2 \subfile{../subfiles/chap_time_domain} %% 2. Time discretisation (time stepping strategy) 3 \subfile{../subfiles/chap_DOM} %% 3. Space discretisation 4 \subfile{../subfiles/chap_TRA} %% 4. Tracer advection/diffusion equation 5 \subfile{../subfiles/chap_DYN} %% 5. Dynamics : momentum equation 6 \subfile{../subfiles/chap_SBC} %% 6. Surface Boundary Conditions 7 \subfile{../subfiles/chap_LBC} %% 7. Lateral Boundary Conditions 8 \subfile{../subfiles/chap_LDF} %% 8. Lateral diffusion 9 \subfile{../subfiles/chap_ZDF} %% 9. Vertical diffusion 10 \subfile{../subfiles/chap_DIA} %% 10. Outputs and Diagnostics 11 \subfile{../subfiles/chap_OBS} %% 11. Observation operator 12 \subfile{../subfiles/chap_ASM} %% 12. Assimilation increments 13 \subfile{../subfiles/chap_STO} %% 13. Stochastic param. 14 \subfile{../subfiles/chap_misc} %% 14. Miscellaneous topics 15 \subfile{../subfiles/chap_cfgs} %% 15. Predefined configurations 16 17 %% Not included 18 %\subfile{../subfiles/chap_model_basics_zstar} 19 %\subfile{../subfiles/chap_DIU} 20 %\subfile{../subfiles/chap_conservation} 1 \subfile{../subfiles/introduction} %% Introduction 2 \subfile{../subfiles/chap_model_basics} 3 \subfile{../subfiles/chap_time_domain} %% Time discretisation (time stepping strategy) 4 \subfile{../subfiles/chap_DOM} %% Space discretisation 5 \subfile{../subfiles/chap_TRA} %% Tracer advection/diffusion equation 6 \subfile{../subfiles/chap_DYN} %% Dynamics : momentum equation 7 \subfile{../subfiles/chap_SBC} %% Surface Boundary Conditions 8 \subfile{../subfiles/chap_LBC} %% Lateral Boundary Conditions 9 \subfile{../subfiles/chap_LDF} %% Lateral diffusion 10 \subfile{../subfiles/chap_ZDF} %% Vertical diffusion 11 \subfile{../subfiles/chap_DIA} %% Outputs and Diagnostics 12 \subfile{../subfiles/chap_OBS} %% Observation operator 13 \subfile{../subfiles/chap_ASM} %% Assimilation increments 14 \subfile{../subfiles/chap_STO} %% Stochastic param. 15 \subfile{../subfiles/chap_misc} %% Miscellaneous topics 16 \subfile{../subfiles/chap_CONFIG} %% Predefined configurations -
NEMO/trunk/doc/latex/NEMO/subfiles/chap_DIA.tex
r12206 r12377 1580 1580 1581 1581 %% ================================================================================================= 1582 \section[Harmonic analysis of tidal constituents (\texttt{\textbf{key\_diaharm}})]{Harmonic analysis of tidal constituents (\protect\key{diaharm})}1583 \label{sec:DIA_diag_harm}1584 1585 \begin{listing}1586 \nlst{nam_diaharm}1587 \caption{\forcode{&nam_diaharm}}1588 \label{lst:nam_diaharm}1589 \end{listing}1590 1591 A module is available to compute the amplitude and phase of tidal waves.1592 This on-line Harmonic analysis is actived with \key{diaharm}.1593 1594 Some parameters are available in namelist \nam{_diaharm}{\_diaharm}:1595 1596 - \np{nit000_han}{nit000\_han} is the first time step used for harmonic analysis1597 1598 - \np{nitend_han}{nitend\_han} is the last time step used for harmonic analysis1599 1600 - \np{nstep_han}{nstep\_han} is the time step frequency for harmonic analysis1601 1602 % - \np{nb_ana}{nb\_ana} is the number of harmonics to analyse1603 1604 - \np{tname}{tname} is an array with names of tidal constituents to analyse1605 1606 \np{nit000_han}{nit000\_han} and \np{nitend_han}{nitend\_han} must be between \np{nit000}{nit000} and \np{nitend}{nitend} of the simulation.1607 The restart capability is not implemented.1608 1609 The Harmonic analysis solve the following equation:1610 1611 \[1612 h_{i} - A_{0} + \sum^{nb\_ana}_{j=1}[A_{j}cos(\nu_{j}t_{j}-\phi_{j})] = e_{i}1613 \]1614 1615 With $A_{j}$, $\nu_{j}$, $\phi_{j}$, the amplitude, frequency and phase for each wave and $e_{i}$ the error.1616 $h_{i}$ is the sea level for the time $t_{i}$ and $A_{0}$ is the mean sea level. \\1617 We can rewrite this equation:1618 1619 \[1620 h_{i} - A_{0} + \sum^{nb\_ana}_{j=1}[C_{j}cos(\nu_{j}t_{j})+S_{j}sin(\nu_{j}t_{j})] = e_{i}1621 \]1622 1623 with $A_{j}=\sqrt{C^{2}_{j}+S^{2}_{j}}$ and $\phi_{j}=arctan(S_{j}/C_{j})$.1624 1625 We obtain in output $C_{j}$ and $S_{j}$ for each tidal wave.1626 1627 %% =================================================================================================1628 1582 \section[Transports across sections (\texttt{\textbf{key\_diadct}})]{Transports across sections (\protect\key{diadct})} 1629 1583 \label{sec:DIA_diag_dct} -
NEMO/trunk/doc/latex/NEMO/subfiles/chap_SBC.tex
r11693 r12377 1 1 \documentclass[../main/NEMO_manual]{subfiles} 2 \usepackage{fontspec} 3 \usepackage{fontawesome} 2 4 3 5 \begin{document} … … 45 47 46 48 \begin{itemize} 47 \item a bulk formulation (\np[=.true.]{ln_blk}{ln\_blk} with four possible bulk algorithms),49 \item a bulk formulation (\np[=.true.]{ln_blk}{ln\_blk}), featuring a selection of four bulk parameterization algorithms, 48 50 \item a flux formulation (\np[=.true.]{ln_flx}{ln\_flx}), 49 51 \item a coupled or mixed forced/coupled formulation (exchanges with a atmospheric model via the OASIS coupler), … … 504 506 \label{sec:SBC_flx} 505 507 508 % Laurent: DO NOT mix up ``bulk formulae'' (the classic equation) and the ``bulk 509 % parameterization'' (i.e NCAR, COARE, ECMWF...) 510 506 511 \begin{listing} 507 512 \nlst{namsbc_flx} … … 520 525 See \autoref{subsec:SBC_ssr} for its specification. 521 526 522 %% ================================================================================================= 527 528 529 530 531 532 533 %% ================================================================================================= 534 \pagebreak 535 \newpage 523 536 \section[Bulk formulation (\textit{sbcblk.F90})]{Bulk formulation (\protect\mdl{sbcblk})} 524 537 \label{sec:SBC_blk} 538 539 % L. Brodeau, December 2019... % 525 540 526 541 \begin{listing} … … 530 545 \end{listing} 531 546 532 In the bulk formulation, the surface boundary condition fields are computed with bulk formulae using atmospheric fields 533 and ocean (and sea-ice) variables averaged over \np{nn_fsbc}{nn\_fsbc} time-step. 534 535 The atmospheric fields used depend on the bulk formulae used. 536 In forced mode, when a sea-ice model is used, a specific bulk formulation is used. 537 Therefore, different bulk formulae are used for the turbulent fluxes computation 538 over the ocean and over sea-ice surface. 539 For the ocean, four bulk formulations are available thanks to the \href{https://brodeau.github.io/aerobulk/}{Aerobulk} package (\citet{brodeau.barnier.ea_JPO16}): 540 the NCAR (formerly named CORE), COARE 3.0, COARE 3.5 and ECMWF bulk formulae. 541 The choice is made by setting to true one of the following namelist variable: 542 \np{ln_NCAR}{ln\_NCAR}, \np{ln_COARE_3p0}{ln\_COARE\_3p0}, \np{ln_COARE_3p5}{ln\_COARE\_3p5} and \np{ln_ECMWF}{ln\_ECMWF}. 543 For sea-ice, three possibilities can be selected: 544 a constant transfer coefficient (1.4e-3; default value), \citet{lupkes.gryanik.ea_JGR12} (\np{ln_Cd_L12}{ln\_Cd\_L12}), and \citet{lupkes.gryanik_JGR15} (\np{ln_Cd_L15}{ln\_Cd\_L15}) parameterizations 547 If the bulk formulation is selected (\np[=.true.]{ln_blk}{ln\_blk}), the air-sea 548 fluxes associated with surface boundary conditions are estimated by means of the 549 traditional \emph{bulk formulae}. As input, bulk formulae rely on a prescribed 550 near-surface atmosphere state (typically extracted from a weather reanalysis) 551 and the prognostic sea (-ice) surface state averaged over \np{nn_fsbc}{nn\_fsbc} 552 time-step(s). 553 554 % Turbulent air-sea fluxes are computed using the sea surface properties and 555 % atmospheric SSVs at height $z$ above the sea surface, with the traditional 556 % aerodynamic bulk formulae: 557 558 Note: all the NEMO Fortran routines involved in the present section have been 559 initially developed (and are still developed in parallel) in 560 the \href{https://brodeau.github.io/aerobulk/}{\texttt{AeroBulk}} open-source project 561 \citep{brodeau.barnier.ea_JPO17}. 562 563 %%% Bulk formulae are this: 564 \subsection{Bulk formulae}\label{subsec:SBC_blkform} 565 % 566 In NEMO, the set of equations that relate each component of the surface fluxes 567 to the near-surface atmosphere and sea surface states writes 568 % 569 \begin{subequations}\label{eq_bulk} 570 \label{eq:SBC_bulk_form} 571 \begin{eqnarray} 572 \mathbf{\tau} &=& \rho~ C_D ~ \mathbf{U}_z ~ U_B \\ 573 Q_H &=& \rho~C_H~C_P~\big[ \theta_z - T_s \big] ~ U_B \\ 574 E &=& \rho~C_E ~\big[ q_s - q_z \big] ~ U_B \\ 575 Q_L &=& -L_v \, E \\ 576 % 577 Q_{sr} &=& (1 - a) Q_{sw\downarrow} \\ 578 Q_{ir} &=& \delta (Q_{lw\downarrow} -\sigma T_s^4) 579 \end{eqnarray} 580 \end{subequations} 581 % 582 with 583 \[ \theta_z \simeq T_z+\gamma z \] 584 \[ q_s \simeq 0.98\,q_{sat}(T_s,p_a ) \] 585 % 586 from which, the the non-solar heat flux is \[ Q_{ns} = Q_L + Q_H + Q_{ir} \] 587 % 588 where $\mathbf{\tau}$ is the wind stress vector, $Q_H$ the sensible heat flux, 589 $E$ the evaporation, $Q_L$ the latent heat flux, and $Q_{ir}$ the net longwave 590 flux. 591 % 592 $Q_{sw\downarrow}$ and $Q_{lw\downarrow}$ are the surface downwelling shortwave 593 and longwave radiative fluxes, respectively. 594 % 595 Note: a positive sign for $\mathbf{\tau}$, $Q_H$, $Q_L$, $Q_{sr}$ or $Q_{ir}$ 596 implies a gain of the relevant quantity for the ocean, while a positive $E$ 597 implies a freshwater loss for the ocean. 598 % 599 $\rho$ is the density of air. $C_D$, $C_H$ and $C_E$ are the bulk transfer 600 coefficients for momentum, sensible heat, and moisture, respectively. 601 % 602 $C_P$ is the heat capacity of moist air, and $L_v$ is the latent heat of 603 vaporization of water. 604 % 605 $\theta_z$, $T_z$ and $q_z$ are the potential temperature, absolute temperature, 606 and specific humidity of air at height $z$ above the sea surface, 607 respectively. $\gamma z$ is a temperature correction term which accounts for the 608 adiabatic lapse rate and approximates the potential temperature at height 609 $z$ \citep{josey.gulev.ea_2013}. 610 % 611 $\mathbf{U}_z$ is the wind speed vector at height $z$ above the sea surface 612 (possibly referenced to the surface current $\mathbf{u_0}$, 613 section \ref{s_res1}.\ref{ss_current}). 614 % 615 The bulk scalar wind speed, namely $U_B$, is the scalar wind speed, 616 $|\mathbf{U}_z|$, with the potential inclusion of a gustiness contribution. 617 % 618 $a$ and $\delta$ are the albedo and emissivity of the sea surface, respectively.\\ 619 % 620 %$p_a$ is the mean sea-level pressure (SLP). 621 % 622 $T_s$ is the sea surface temperature. $q_s$ is the saturation specific humidity 623 of air at temperature $T_s$; it includes a 2\% reduction to account for the 624 presence of salt in seawater \citep{sverdrup.johnson.ea_1942,kraus.businger_QJRMS96}. 625 Depending on the bulk parametrization used, $T_s$ can either be the temperature 626 at the air-sea interface (skin temperature, hereafter SSST) or at typically a 627 few tens of centimeters below the surface (bulk sea surface temperature, 628 hereafter SST). 629 % 630 The SSST differs from the SST due to the contributions of two effects of 631 opposite sign, the \emph{cool skin} and \emph{warm layer} (hereafter CS and WL, 632 respectively, see section\,\ref{subsec:SBC_skin}). 633 % 634 Technically, when the ECMWF or COARE* bulk parametrizations are selected 635 (\np[=.true.]{ln_ECMWF}{ln\_ECMWF} or \np[=.true.]{ln_COARE*}{ln\_COARE\*}), 636 $T_s$ is the SSST, as opposed to the NCAR bulk parametrization 637 (\np[=.true.]{ln_NCAR}{ln\_NCAR}) for which $T_s$ is the bulk SST (\ie~temperature 638 at first T-point level). 639 640 For more details on all these aspects the reader is invited to refer 641 to \citet{brodeau.barnier.ea_JPO17}. 642 643 644 645 \subsection{Bulk parametrizations}\label{subsec:SBC_blk_ocean} 646 %%%\label{subsec:SBC_param} 647 648 Accuracy of the estimate of surface turbulent fluxes by means of bulk formulae 649 strongly relies on that of the bulk transfer coefficients: $C_D$, $C_H$ and 650 $C_E$. They are estimated with what we refer to as a \emph{bulk 651 parametrization} algorithm. When relevant, these algorithms also perform the 652 height adjustment of humidity and temperature to the wind reference measurement 653 height (from \np{rn_zqt}{rn\_zqt} to \np{rn_zu}{rn\_zu}). 654 655 656 657 For the open ocean, four bulk parametrization algorithms are available in NEMO: 658 \begin{itemize} 659 \item NCAR, formerly known as CORE, \citep{large.yeager_rpt04,large.yeager_CD09} 660 \item COARE 3.0 \citep{fairall.bradley.ea_JC03} 661 \item COARE 3.6 \citep{edson.jampana.ea_JPO13} 662 \item ECMWF (IFS documentation, cy45) 663 \end{itemize} 664 665 666 With respect to version 3, the principal advances in version 3.6 of the COARE 667 bulk parametrization are built around improvements in the representation of the 668 effects of waves on 669 fluxes \citep{edson.jampana.ea_JPO13,brodeau.barnier.ea_JPO17}. This includes 670 improved relationships of surface roughness, and whitecap fraction on wave 671 parameters. It is therefore recommended to chose version 3.6 over 3. 672 673 674 675 676 \subsection{Cool-skin and warm-layer parametrizations}\label{subsec:SBC_skin} 677 %\subsection[Cool-skin and warm-layer parameterizations 678 %(\forcode{ln_skin_cs} \& \forcode{ln_skin_wl})]{Cool-skin and warm-layer parameterizations (\protect\np{ln_skin_cs}{ln\_skin\_cs} \& \np{ln_skin_wl}{ln\_skin\_wl})} 679 %\label{subsec:SBC_skin} 680 % 681 As opposed to the NCAR bulk parametrization, more advanced bulk 682 parametrizations such as COARE3.x and ECMWF are meant to be used with the skin 683 temperature $T_s$ rather than the bulk SST (which, in NEMO is the temperature at 684 the first T-point level, see section\,\ref{subsec:SBC_blkform}). 685 % 686 As such, the relevant cool-skin and warm-layer parametrization must be 687 activated through \np[=T]{ln_skin_cs}{ln\_skin\_cs} 688 and \np[=T]{ln_skin_wl}{ln\_skin\_wl} to use COARE3.x or ECMWF in a consistent 689 way. 690 691 \texttt{\#LB: ADD BLBLA ABOUT THE TWO CS/WL PARAMETRIZATIONS (ECMWF and COARE) !!!} 692 693 For the cool-skin scheme parametrization COARE and ECMWF algorithms share the same 694 basis: \citet{fairall.bradley.ea_JGR96}. With some minor updates based 695 on \citet{zeng.beljaars_GRL05} for ECMWF, and \citet{fairall.ea_19} for COARE 696 3.6. 697 698 For the warm-layer scheme, ECMWF is based on \citet{zeng.beljaars_GRL05} with a 699 recent update from \citet{takaya.bidlot.ea_JGR10} (consideration of the 700 turbulence input from Langmuir circulation). 701 702 Importantly, COARE warm-layer scheme \citep{fairall.ea_19} includes a prognostic 703 equation for the thickness of the warm-layer, while it is considered as constant 704 in the ECWMF algorithm. 705 706 707 \subsection{Appropriate use of each bulk parametrization} 708 709 \subsubsection{NCAR} 710 711 NCAR bulk parametrizations (formerly known as CORE) is meant to be used with the 712 CORE II atmospheric forcing \citep{large.yeager_CD09}. The expected sea surface 713 temperature is the bulk SST. Hence the following namelist parameters must be 714 set: 715 % 716 \begin{verbatim} 717 ... 718 ln_NCAR = .true. 719 ... 720 rn_zqt = 10. ! Air temperature & humidity reference height (m) 721 rn_zu = 10. ! Wind vector reference height (m) 722 ... 723 ln_skin_cs = .false. ! use the cool-skin parameterization 724 ln_skin_wl = .false. ! use the warm-layer parameterization 725 ... 726 ln_humi_sph = .true. ! humidity "sn_humi" is specific humidity [kg/kg] 727 \end{verbatim} 728 729 730 \subsubsection{ECMWF} 731 % 732 With an atmospheric forcing based on a reanalysis of the ECMWF, such as the 733 Drakkar Forcing Set \citep{brodeau.barnier.ea_OM10}, we strongly recommend to 734 use the ECMWF bulk parametrizations with the cool-skin and warm-layer 735 parametrizations activated. In ECMWF reanalyzes, since air temperature and 736 humidity are provided at the 2\,m height, and given that the humidity is 737 distributed as the dew-point temperature, the namelist must be tuned as follows: 738 % 739 \begin{verbatim} 740 ... 741 ln_ECMWF = .true. 742 ... 743 rn_zqt = 2. ! Air temperature & humidity reference height (m) 744 rn_zu = 10. ! Wind vector reference height (m) 745 ... 746 ln_skin_cs = .true. ! use the cool-skin parameterization 747 ln_skin_wl = .true. ! use the warm-layer parameterization 748 ... 749 ln_humi_dpt = .true. ! humidity "sn_humi" is dew-point temperature [K] 750 ... 751 \end{verbatim} 752 % 753 Note: when \np{ln_ECMWF}{ln\_ECMWF} is selected, the selection 754 of \np{ln_skin_cs}{ln\_skin\_cs} and \np{ln_skin_wl}{ln\_skin\_wl} implicitly 755 triggers the use of the ECMWF cool-skin and warm-layer parametrizations, 756 respectively (found in \textit{sbcblk\_skin\_ecmwf.F90}). 757 758 759 \subsubsection{COARE 3.x} 760 % 761 Since the ECMWF parametrization is largely based on the COARE* parametrization, 762 the two algorithms are very similar in terms of structure and closure 763 approach. As such, the namelist tuning for COARE 3.x is identical to that of 764 ECMWF: 765 % 766 \begin{verbatim} 767 ... 768 ln_COARE3p6 = .true. 769 ... 770 ln_skin_cs = .true. ! use the cool-skin parameterization 771 ln_skin_wl = .true. ! use the warm-layer parameterization 772 ... 773 \end{verbatim} 774 775 Note: when \np[=T]{ln_COARE3p0}{ln\_COARE3p0} is selected, the selection 776 of \np{ln_skin_cs}{ln\_skin\_cs} and \np{ln_skin_wl}{ln\_skin\_wl} implicitly 777 triggers the use of the COARE cool-skin and warm-layer parametrizations, 778 respectively (found in \textit{sbcblk\_skin\_coare.F90}). 779 780 781 %lulu 782 783 784 785 % In a typical bulk algorithm, the BTCs under neutral stability conditions are 786 % defined using \emph{in-situ} flux measurements while their dependence on the 787 % stability is accounted through the \emph{Monin-Obukhov Similarity Theory} and 788 % the \emph{flux-profile} relationships \citep[\eg{}][]{Paulson_1970}. BTCs are 789 % functions of the wind speed and the near-surface stability of the atmospheric 790 % surface layer (hereafter ASL), and hence, depend on $U_B$, $T_s$, $T_z$, $q_s$ 791 % and $q_z$. 792 793 794 795 \subsection{Prescribed near-surface atmospheric state} 796 797 The atmospheric fields used depend on the bulk formulae used. In forced mode, 798 when a sea-ice model is used, a specific bulk formulation is used. Therefore, 799 different bulk formulae are used for the turbulent fluxes computation over the 800 ocean and over sea-ice surface. 801 % 802 803 %The choice is made by setting to true one of the following namelist 804 %variable: \np{ln_NCAR}{ln\_NCAR}, \np{ln_COARE_3p0}{ln\_COARE\_3p0}, \np{ln_COARE_3p6}{ln\_COARE\_3p6} 805 %and \np{ln_ECMWF}{ln\_ECMWF}. 545 806 546 807 Common options are defined through the \nam{sbc_blk}{sbc\_blk} namelist variables. … … 553 814 Variable description & Model variable & Units & point \\ 554 815 \hline 555 i-component of the 10m air velocity & utau& $m.s^{-1}$ & T \\816 i-component of the 10m air velocity & wndi & $m.s^{-1}$ & T \\ 556 817 \hline 557 j-component of the 10m air velocity & vtau& $m.s^{-1}$ & T \\818 j-component of the 10m air velocity & wndj & $m.s^{-1}$ & T \\ 558 819 \hline 559 10m air temperature & tair & \r{}$K$& T \\820 10m air temperature & tair & $K$ & T \\ 560 821 \hline 561 Specific humidity & humi & \% & T \\ 822 Specific humidity & humi & $-$ & T \\ 823 Relative humidity & ~ & $\%$ & T \\ 824 Dew-point temperature & ~ & $K$ & T \\ 562 825 \hline 563 Incoming long wave radiation& qlw & $W.m^{-2}$ & T \\826 Downwelling longwave radiation & qlw & $W.m^{-2}$ & T \\ 564 827 \hline 565 Incoming short wave radiation& qsr & $W.m^{-2}$ & T \\828 Downwelling shortwave radiation & qsr & $W.m^{-2}$ & T \\ 566 829 \hline 567 830 Total precipitation (liquid + solid) & precip & $Kg.m^{-2}.s^{-1}$ & T \\ … … 584 847 585 848 \np{cn_dir}{cn\_dir} is the directory of location of bulk files 586 \np{ln_taudif}{ln\_taudif} is the flag to specify if we use HightFrequency (HF) tau information (.true.) or not (.false.)849 %\np{ln_taudif}{ln\_taudif} is the flag to specify if we use High Frequency (HF) tau information (.true.) or not (.false.) 587 850 \np{rn_zqt}{rn\_zqt}: is the height of humidity and temperature measurements (m) 588 851 \np{rn_zu}{rn\_zu}: is the height of wind measurements (m) … … 595 858 Its range must be between zero and one, and it is recommended to set it to 0 at low-resolution (ORCA2 configuration). 596 859 597 As for the flux formulation, information about the input data required by the model is provided in860 As for the flux parametrization, information about the input data required by the model is provided in 598 861 the namsbc\_blk namelist (see \autoref{subsec:SBC_fldread}). 599 862 600 %% ================================================================================================= 601 \subsection[Ocean-Atmosphere Bulk formulae (\textit{sbcblk\_algo\_coare.F90, sbcblk\_algo\_coare3p5.F90, sbcblk\_algo\_ecmwf.F90, sbcblk\_algo\_ncar.F90})]{Ocean-Atmosphere Bulk formulae (\mdl{sbcblk\_algo\_coare}, \mdl{sbcblk\_algo\_coare3p5}, \mdl{sbcblk\_algo\_ecmwf}, \mdl{sbcblk\_algo\_ncar})} 602 \label{subsec:SBC_blk_ocean} 603 604 Four different bulk algorithms are available to compute surface turbulent momentum and heat fluxes over the ocean. 605 COARE 3.0, COARE 3.5 and ECMWF schemes mainly differ by their roughness lenghts computation and consequently 606 their neutral transfer coefficients relationships with neutral wind. 607 \begin{itemize} 608 \item NCAR (\np[=.true.]{ln_NCAR}{ln\_NCAR}): The NCAR bulk formulae have been developed by \citet{large.yeager_rpt04}. 609 They have been designed to handle the NCAR forcing, a mixture of NCEP reanalysis and satellite data. 610 They use an inertial dissipative method to compute the turbulent transfer coefficients 611 (momentum, sensible heat and evaporation) from the 10m wind speed, air temperature and specific humidity. 612 This \citet{large.yeager_rpt04} dataset is available through 613 the \href{http://nomads.gfdl.noaa.gov/nomads/forms/mom4/NCAR.html}{GFDL web site}. 614 Note that substituting ERA40 to NCEP reanalysis fields does not require changes in the bulk formulea themself. 615 This is the so-called DRAKKAR Forcing Set (DFS) \citep{brodeau.barnier.ea_OM10}. 616 \item COARE 3.0 (\np[=.true.]{ln_COARE_3p0}{ln\_COARE\_3p0}): See \citet{fairall.bradley.ea_JC03} for more details 617 \item COARE 3.5 (\np[=.true.]{ln_COARE_3p5}{ln\_COARE\_3p5}): See \citet{edson.jampana.ea_JPO13} for more details 618 \item ECMWF (\np[=.true.]{ln_ECMWF}{ln\_ECMWF}): Based on \href{https://www.ecmwf.int/node/9221}{IFS (Cy31)} implementation and documentation. 619 Surface roughness lengths needed for the Obukhov length are computed following \citet{beljaars_QJRMS95}. 620 \end{itemize} 863 864 \subsubsection{Air humidity} 865 866 Air humidity can be provided as three different parameters: specific humidity 867 [kg/kg], relative humidity [\%], or dew-point temperature [K] (LINK to namelist 868 parameters)... 869 870 871 ~\\ 872 873 874 875 876 877 878 879 880 881 882 %% ================================================================================================= 883 %\subsection[Ocean-Atmosphere Bulk formulae (\textit{sbcblk\_algo\_coare3p0.F90, sbcblk\_algo\_coare3p6.F90, %sbcblk\_algo\_ecmwf.F90, sbcblk\_algo\_ncar.F90})]{Ocean-Atmosphere Bulk formulae (\mdl{sbcblk\_algo\_coare3p0}, %\mdl{sbcblk\_algo\_coare3p6}, \mdl{sbcblk\_algo\_ecmwf}, \mdl{sbcblk\_algo\_ncar})} 884 %\label{subsec:SBC_blk_ocean} 885 886 %Four different bulk algorithms are available to compute surface turbulent momentum and heat fluxes over the ocean. 887 %COARE 3.0, COARE 3.6 and ECMWF schemes mainly differ by their roughness lenghts computation and consequently 888 %their neutral transfer coefficients relationships with neutral wind. 889 %\begin{itemize} 890 %\item NCAR (\np[=.true.]{ln_NCAR}{ln\_NCAR}): The NCAR bulk formulae have been developed by \citet{large.yeager_rpt04}. 891 % They have been designed to handle the NCAR forcing, a mixture of NCEP reanalysis and satellite data. 892 % They use an inertial dissipative method to compute the turbulent transfer coefficients 893 % (momentum, sensible heat and evaporation) from the 10m wind speed, air temperature and specific humidity. 894 % This \citet{large.yeager_rpt04} dataset is available through 895 % the \href{http://nomads.gfdl.noaa.gov/nomads/forms/mom4/NCAR.html}{GFDL web site}. 896 % Note that substituting ERA40 to NCEP reanalysis fields does not require changes in the bulk formulea themself. 897 % This is the so-called DRAKKAR Forcing Set (DFS) \citep{brodeau.barnier.ea_OM10}. 898 %\item COARE 3.0 (\np[=.true.]{ln_COARE_3p0}{ln\_COARE\_3p0}): See \citet{fairall.bradley.ea_JC03} for more details 899 %\item COARE 3.6 (\np[=.true.]{ln_COARE_3p6}{ln\_COARE\_3p6}): See \citet{edson.jampana.ea_JPO13} for more details 900 %\item ECMWF (\np[=.true.]{ln_ECMWF}{ln\_ECMWF}): Based on \href{https://www.ecmwf.int/node/9204}{IFS (Cy40r1)} %implementation and documentation. 901 % Surface roughness lengths needed for the Obukhov length are computed 902 % following \citet{beljaars_QJRMS95}. 903 %\end{itemize} 621 904 622 905 %% ================================================================================================= 623 906 \subsection{Ice-Atmosphere Bulk formulae} 624 907 \label{subsec:SBC_blk_ice} 908 909 910 \texttt{\#out\_of\_place:} 911 For sea-ice, three possibilities can be selected: 912 a constant transfer coefficient (1.4e-3; default 913 value), \citet{lupkes.gryanik.ea_JGR12} (\np{ln_Cd_L12}{ln\_Cd\_L12}), 914 and \citet{lupkes.gryanik_JGR15} (\np{ln_Cd_L15}{ln\_Cd\_L15}) parameterizations 915 \texttt{\#out\_of\_place.} 916 917 918 625 919 626 920 Surface turbulent fluxes between sea-ice and the atmosphere can be computed in three different ways: -
NEMO/trunk/doc/latex/NEMO/subfiles/chap_misc.tex
r11693 r12377 362 362 363 363 %% ================================================================================================= 364 \subsection{Control print} 365 366 The \np{ln_ctl}{ln\_ctl} switch was originally used as a debugging option in two modes: 367 368 \begin{enumerate} 369 \item {\np{ln_ctl}{ln\_ctl}: compute and print the trends averaged over the interior domain in all TRA, DYN, LDF and 370 ZDF modules. 371 This option is very helpful when diagnosing the origin of an undesired change in model results. } 372 373 \item {also \np{ln_ctl}{ln\_ctl} but using the nictl and njctl namelist parameters to check the source of differences between 374 mono and multi processor runs.} 364 \subsection{Status and debugging information output} 365 366 367 NEMO can produce a range of text information output either: in the main output 368 file (ocean.output) written by the normal reporting processor (narea == 1) or various 369 specialist output files (e.g. layout.dat, run.stat, tracer.stat etc.). Some, for example 370 run.stat and tracer.stat, contain globally collected values for which a single file is 371 sufficient. Others, however, contain information that could, potentially, be different 372 for each processing region. For computational efficiency, the default volume of text 373 information produced is reduced to just a few files from the narea=1 processor. 374 375 When more information is required for monitoring or debugging purposes, the various 376 forms of output can be selected via the \np{sn\_cfctl} structure. As well as simple 377 on-off switches this structure also allows selection of a range of processors for 378 individual reporting (where appropriate) and a time-increment option to restrict 379 globally collected values to specified time-step increments. 380 381 Most options within the structure are influenced by the top-level switches shown here 382 with their default settings: 383 384 \begin{verbatim} 385 sn_cfctl%l_allon = .FALSE. ! IF T activate all options. If F deactivate all unless l_config is T 386 sn_cfctl%l_config = .TRUE. ! IF .true. then control which reports are written with the following 387 \end{verbatim} 388 389 The first switch is a convenience option which can be used to switch on and off all 390 sub-options. However, if it is false then switching off all sub-options is only done 391 if \texttt{sn_cfctl%l\_config} is also false. Specifically, the logic is: 392 393 \begin{verbatim} 394 IF ( sn_cfctl%l_allon ) THEN 395 set all suboptions .TRUE. 396 and set procmin, procmax and procincr so that all regions are selected ([0,10000000,1], respectively) 397 ELSEIF ( sn_cfctl%l_config ) THEN 398 honour individual settings of the suboptions from the namelist 399 ELSE 400 set all suboptions .FALSE. 401 ENDIF 402 \end{verbatim} 403 404 Details of the suboptions follow but first an explanation of the stand-alone option: 405 \texttt{sn_cfctl%l_glochk}. This option modifies the action of the early warning checks 406 carried out in \textt{stpctl.F90}. These checks detect probable numerical instabilites 407 by searching for excessive sea surface heights or velocities and salinity values 408 outside a sensible physical range. If breaches are detected then the default behaviour 409 is to locate and report the local indices of the grid-point in breach. These indices 410 are included in the error message that precedes the model shutdown. When true, 411 \texttt{sn_cfctl%l_glochk} modifies this action by performing a global location of 412 the various minimum and maximum values and the global indices are reported. This has 413 some value in locating the most severe error in cases where the first detected error 414 may not be the worst culprit. 415 416 \subsubsection{Control print suboptions} 417 418 The options that can be individually selected fall into three categories: 419 420 \begin{enumerate} \item{Time step progress information} This category includes 421 \texttt{run.stat} and \texttt{tracer.stat} files which record certain physical and 422 passive tracer metrics (respectively). Typical contents of \texttt{run.stat} include 423 global maximums of ssh, velocity; and global minimums and maximums of temperature 424 and salinity. A netCDF version of \texttt{run.stat} (\texttt{run.stat.nc}) is also 425 produced with the same time-series data and this can easily be expanded to include 426 extra monitoring information. \texttt{tracer.stat} contains the volume-weighted 427 average tracer value for each passive tracer. Collecting these metrics involves 428 global communications and will impact on model efficiency so both these options are 429 disabled by default by setting the respective options, \texttt{sn\_cfctl%runstat} and 430 \texttt{sn\_cfctl%trcstat} to false. A compromise can be made by activating either or 431 both of these options and setting the \texttt{sn\_cfctl%timincr} entry to an integer 432 value greater than one. This increment determines the time-step frequency at which 433 the global metrics are collected and reported. This increment also applies to the 434 time.step file which is otherwise updated every timestep. 435 \item{One-time configuration information/progress logs} 436 437 Some run-time configuration information and limited progress information is always 438 produced by the first ocean process. This includes the \texttt{ocean.output} file 439 which reports on all the namelist options read by the model and remains open to catch 440 any warning or error messages generated during execution. A \texttt{layout.dat} 441 file is also produced which details the MPI-decomposition used by the model. The 442 suboptions: \texttt{sn\_cfctl%oceout} and \texttt{sn\_cfctl%layout} can be used 443 to activate the creation of these files by all ocean processes. For example, 444 when \texttt{sn\_cfctl%oceout} is true all processors produce their own version of 445 \texttt{ocean.output}. All files, beyond the the normal reporting processor (narea == 1), are 446 named with a \_XXXX extension to their name, where XXXX is a 4-digit area number (with 447 leading zeros, if required). This is useful as a debugging aid since all processes can 448 report their local conditions. Note though that these files are buffered on most UNIX 449 systems so bug-hunting efforts using this facility should also utilise the \fortran: 450 451 \begin{verbatim} 452 CALL FLUSH(numout) 453 \end{verbatim} 454 455 statement after any additional write statements to ensure that file contents reflect 456 the last model state. Associated with the \texttt{sn\_cfctl%oceout} option is the 457 additional \texttt{sn\_cfctl%oasout} suboption. This does not activate its own output 458 file but rather activates the writing of addition information regarding the OASIS 459 configuration when coupling via oasis and the sbccpl routine. This information is 460 written to any active \texttt{ocean.output} files. 461 \item{Control sums of trends for debugging} 462 463 NEMO includes an option for debugging reproducibility differences between 464 a MPP and mono-processor runs. This is somewhat dated and clearly only 465 useful for this purpose when dealing with configurations that can be run 466 on a single processor. The full details can be found in this report: \href{ 467 http://forge.ipsl.jussieu.fr/nemo/attachment/wiki/Documentation/prtctl_NEMO_doc_v2.pdf}{The 468 control print option in NEMO} The switches to activate production of the control sums 469 of trends for either the physics or passive tracers are the \texttt{sn\_cfctl%prtctl} 470 and \texttt{sn\_cfctl%prttrc} suboptions, respectively. Although, perhaps, of limited use for its 471 original intention, the ability to produce these control sums of trends in specific 472 areas provides another tool for diagnosing model behaviour. If only the output from a 473 select few regions is required then additional options are available to activate options 474 for only a simple subset of processing regions. These are: \texttt{sn\_cfctl%procmin}, 475 \texttt{sn\_cfctl%procmax} and \texttt{sn\_cfctl%procincr} which can be used to specify 476 the minimum and maximum active areas and the increment. The default values are set 477 such that all regions will be active. Note this subsetting can also be used to limit 478 which additional \texttt{ocean.output} and \texttt{layout.dat} files are produced if 479 those suboptions are active. 480 375 481 \end{enumerate} 376 482 377 However, in recent versions it has also been used to force all processors to assume the 378 reporting role. Thus when \np{ln_ctl}{ln\_ctl} is true all processors produce their own versions 379 of files such as: ocean.output, layout.dat, etc. All such files, beyond the the normal 380 reporting processor (narea == 1), are named with a \_XXXX extension to their name, where 381 XXXX is a 4-digit area number (with leading zeros, if required). Other reporting files 382 such as run.stat (and its netCDF counterpart: run.stat.nc) and tracer.stat contain global 383 information and are only ever produced by the reporting master (narea == 1). For version 384 4.0 a start has been made to return \np{ln_ctl}{ln\_ctl} to its original function by introducing 385 a new control structure which allows finer control over which files are produced. This 386 feature is still evolving but it does already allow the user to: select individually the 387 production of run.stat and tracer.stat files and to toggle the production of other files 388 on processors other than the reporting master. These other reporters can be a simple 389 subset of processors as defined by a minimum, maximum and incremental processor number. 390 391 Note, that production of the run.stat and tracer.stat files require global communications. 392 For run.stat, these are global min and max operations to find metrics such as the gloabl 393 maximum velocity. For tracer.stat these are global sums of tracer fields. To improve model 394 performance these operations are disabled by default and, where necessary, any use of the 395 global values have been replaced with local calculations. For example, checks on the CFL 396 criterion are now done on the local domain and only reported if a breach is detected. 397 398 Experienced users may wish to still monitor this information as a check on model progress. 399 If so, the best compromise will be to activate the files with: 400 401 \begin{verbatim} 402 sn_cfctl%l_config = .TRUE. 403 sn_cfctl%l_runstat = .TRUE. 404 sn_cfctl%l_trcstat = .TRUE. 405 \end{verbatim} 406 407 and to use the new time increment setting to ensure the values are collected and reported 408 at a suitably long interval. For example: 409 410 \begin{verbatim} 411 sn_cfctl%ptimincr = 25 412 \end{verbatim} 413 414 will carry out the global communications and write the information every 25 timesteps. This 415 increment also applies to the time.step file which is otherwise updated every timestep. 483 484 sn_cfctl%l_glochk = .FALSE. ! Range sanity checks are local (F) or global (T). Set T for debugging only 485 sn_cfctl%l_allon = .FALSE. ! IF T activate all options. If F deactivate all unless l_config is T 486 sn_cfctl%l_config = .TRUE. ! IF .true. then control which reports are written with the following 487 sn_cfctl%l_runstat = .FALSE. ! switches and which areas produce reports with the proc integer settings. 488 sn_cfctl%l_trcstat = .FALSE. ! The default settings for the proc integers should ensure 489 sn_cfctl%l_oceout = .FALSE. ! that all areas report. 490 sn_cfctl%l_layout = .FALSE. ! 491 sn_cfctl%l_prtctl = .FALSE. ! 492 sn_cfctl%l_prttrc = .FALSE. ! 493 sn_cfctl%l_oasout = .FALSE. ! 494 sn_cfctl%procmin = 0 ! Minimum area number for reporting [default:0] 495 sn_cfctl%procmax = 1000000 ! Maximum area number for reporting [default:1000000] 496 sn_cfctl%procincr = 1 ! Increment for optional subsetting of areas [default:1] 497 sn_cfctl%ptimincr = 1 ! Timestep increment for writing time step progress info 498 499 416 500 417 501 \subinc{\input{../../global/epilogue}} -
NEMO/trunk/doc/latex/SI3/build
- Property svn:ignore
-
old new 14 14 *.pdf 15 15 *.toc 16 *.xdv17 16 _minted-*
-
- Property svn:ignore
-
NEMO/trunk/doc/latex/SI3/main/chapters.tex
r11537 r12377 1 1 \subfile{../subfiles/todolist} 2 3 \subfile{../subfiles/introduction} % Introduction 2 4 3 5 \subfile{../subfiles/chap_model_basics} -
NEMO/trunk/doc/latex/TOP/build
- Property svn:ignore
-
old new 14 14 *.pdf 15 15 *.toc 16 *.xdv17 16 _minted-*
-
- Property svn:ignore
-
NEMO/trunk/doc/latex/TOP/main/chapters.tex
r11591 r12377 1 \subfile{../subfiles/introduction} 1 2 \subfile{../subfiles/model_description} 2 3 \subfile{../subfiles/model_setup} -
NEMO/trunk/doc/latex/global
-
Property
svn:ignore
set to
*.aux
-
Property
svn:ignore
set to
-
NEMO/trunk/doc/latex/global/document.tex
r11693 r12377 1 1 2 %% ============================================================================== ===================3 %% Template structure for reference manual s4 %% ============================================================================== ===================2 %% ============================================================================== 3 %% Template structure for reference manual 4 %% ============================================================================== 5 5 6 6 %% NEMO release version 7 \def \version{ trunk}7 \def \version{4.0rc~} 8 8 9 9 %% Preamble 10 %% ============================================================================== ===================10 %% ============================================================================== 11 11 12 12 %% Document layout 13 \documentclass[ fontsize = 10pt, twoside, abstract]{scrreprt}13 \documentclass[draft]{scrreprt} 14 14 15 %% Load manual configuration 16 \input{../../global/prologue} 15 %% Load the configuration of the manual 16 \input{../main/definitions} 17 18 %% Load global *.tex files 19 \input{../../global/preamble} 20 21 \dominitoc 22 23 %% Launch the creation of the indexes 24 \input{../../global/indexes} 25 17 26 18 27 %% End of common preamble between main and sub-files 19 28 %% Override custom cmds for full manual compilation 20 \newcommand{\ subinc}[1]{#1}21 \newcommand{\ subexc}[1]{}29 \newcommand{\onlyinsubfile}[1]{#1} 30 \newcommand{\notinsubfile}[1]{} 22 31 23 32 \begin{document} 24 33 25 \renewcommand{\subinc}[1]{} 26 \renewcommand{\subexc}[1]{#1} 34 \renewcommand{\onlyinsubfile}[1]{} 35 \renewcommand{\notinsubfile}[1]{#1} 36 37 \renewcommand{\biblio}{} 38 \renewcommand{\pindex}{} 27 39 28 40 29 41 %% Frontmatter 30 %% ============================================================================== ===================42 %% ============================================================================== 31 43 32 \pagenumbering{gobble} %% Disable page numbering temporarily44 \pagenumbering{gobble} 33 45 34 46 %% Title page 35 47 \input{../../global/frontpage} 36 48 37 %% Footer for introductory parts (no header by cleaning default) 38 \ ofoot[]{\engine\ Reference Manual} \ifoot[]{\pagemark}49 \maketitle 50 \emptythanks 39 51 40 52 %% Information page (2nd page) 41 53 \input{../../global/info_page} 42 54 43 \listoffigures 44 \listoflistings 45 \listoftables 46 47 \clearpage 48 55 %% Foreword 56 %\frontmatter %% Chapter numbering off and Roman numerals for page numbers 49 57 \pagenumbering{roman} 50 \ofoot[]{\engine\ Reference Manual} \ifoot[]{\pagemark} 51 52 \input{introduction} 58 \input{foreword} 53 59 54 60 %% Table of Contents 55 61 \tableofcontents 62 \listoffigures 63 \listoftables 64 \listoflistings 56 65 57 66 \clearpage 67 %\end{document} 58 68 59 69 60 70 %% Mainmatter 61 %% ============================================================================== ===================71 %% ============================================================================== 62 72 63 % % Headings for document body73 %\mainmatter %% Chapter numbering on, page numbering is reset with Arabic numerals 64 74 \pagenumbering{arabic} 65 \lohead{Chap.\ \thechapter\ \leftmark} \rehead{Sect.\ \thesection\ \rightmark}66 \ifoot[]{Page\ \pagemark\ of \pageref*{LastPage}}67 75 68 76 \include{chapters} … … 70 78 71 79 %% Appendix 72 %% ============================================================================== ===================80 %% ============================================================================== 73 81 74 \appendix %% Chapter numbering with letters by now 75 \lohead{Apdx\ \thechapter\ \leftmark} 82 %% Chapter numbering is reset with letters now 83 \appendix 84 76 85 \include{appendices} 77 78 %% Append coding rules for every manual79 \input{../../global/coding_rules}80 86 81 87 82 88 %% Backmatter 83 %% ============================================================================== ===================89 %% ============================================================================== 84 90 85 %% Bibliography and indexes 86 \input{../../global/epilogue} 91 %\backmatter %% Chapter numbering off 92 93 %% Bibliography 94 \phantomsection 95 \addcontentsline{toc}{chapter}{Bibliography} 96 \bibliography{../main/bibliography} 97 98 %% Index 99 \clearpage 100 \phantomsection 101 \addcontentsline{toc}{chapter}{Indexes} 102 \printindex[keys] 103 \printindex[modules] 104 \printindex[blocks] 105 \printindex[parameters] 106 \printindex[subroutines] 87 107 88 108 \end{document} 109 -
NEMO/trunk/doc/latex/global/frontpage.tex
r11688 r12377 1 1 2 \ begin{titlepage}3 % \newgeometry{hmargin = 1.5cm, vmargin = 3cm}4 \setlength{\parindent}{0pt}2 \title{\heading} 3 \author{\firstauthor \and \secondauthor\thanks{\protect\input{thanks}}} 4 \date{\today} 5 5 6 \pretitle{ 6 7 \begin{center} 7 \begin{minipage}{0.3\textwidth} 8 \includegraphics[height=1.5cm]{logos/NEMO_grey} 9 \end{minipage}\begin{minipage}{0.6\textwidth} 10 \begin{center} 11 \Large\slshape 12 \textbf{N}ucleus for \textbf{E}uropean \textbf{M}odelling of the \textbf{O}cean \\ 13 \medskip 14 \hyperref[resources]{\textcolor{black}{ 15 \faWordpress \hspace{0.75cm} \faCodeFork \hspace{0.75cm} 16 \faGithub \hspace{0.75cm} \faCloudDownload \hspace{0.75cm} \faEnvelope 17 } 18 } 19 \end{center} 20 \end{minipage} 8 \begin{figure}[H] 9 \begin{minipage}[c]{0.35\textwidth} 10 \href{http://www.nemo-ocean.eu}{\includegraphics[width=0.7\textwidth]{logos/NEMO_grey}} 11 \end{minipage} 12 \hfill 13 \begin{minipage}[c]{0.65\textwidth} 14 \centering 15 \large{\em{{N}ucleus for {E}uropean {M}odelling of the {O}cean}} 16 \end{minipage} 17 \end{figure} 18 \vfill 19 \Huge 20 } 21 \posttitle{\par\end{center}\vskip 0.5em} 22 \preauthor{\begin{center}\Large\lineskip0.5em\begin{tabular}[t]{c}} 23 \postauthor{\end{tabular}\par\end{center}} 24 \predate{ 25 \vfill 26 \begin{center} 27 \large Version \version --- 28 } 29 \postdate{ 30 \par~\\ 31 \href{http://doi.org/10.5281/zenodo.\zid}{\includegraphics{{badges/zenodo.\zid}.pdf}} 21 32 \end{center} 33 \vfill 34 \begin{center} 35 \href{http://www.cmcc.it}{ \includegraphics[height=0.055\textheight]{logos/CMCC}} 36 \hspace{0.5em} 37 \href{http://www.cnrs.fr}{ \includegraphics[height=0.055\textheight]{logos/CNRS}} 38 \hspace{0.9em} 39 \href{http://www.mercator-ocean.fr}{\includegraphics[height=0.055\textheight]{logos/MOI} } 40 \hspace{0.45em} 41 \href{http://www.metoffice.gov.uk}{ \includegraphics[height=0.055\textheight]{logos/UKMO}} 42 \hspace{0.5em} 43 \href{http://nerc.ukri.org}{ \includegraphics[height=0.055\textheight]{logos/NERC}} \\ 44 \large{{\em{C}ommunity \hspace{1.5em} {O}cean \hspace{1.5em} {M}odel}} 45 \end{center} 46 } 22 47 23 \spacetop 24 \textcolor{white}{\fontsize{0.8cm}{0.8cm}\selectfont\textbf{\heading}} 25 \ifdef{\subheading}{ 26 \medskip 27 \par 28 \textcolor{white}{\Huge \subheading} 29 }{} 30 \spacedown 48 \thanksmarkseries{fnsymbol} 31 49 32 \begin{center}33 \LARGE Version \version\ -\ \today \\34 \medskip35 \href{http://doi.org/10.5281/zenodo.\zid}{ \includegraphics{badges/zenodo.\zid} }36 \end{center}37 38 \vfill39 40 \begin{minipage}{\authorswidth}41 \raggedleft42 \input{authors}43 \end{minipage}\hspace{15pt}\begin{minipage}{0.02\linewidth}44 \rule{1pt}{\rulelenght}45 \end{minipage}\hspace{ 5pt}\begin{minipage}{\abstractwidth}46 \begin{abstract}47 \input{abstract}48 \end{abstract}49 \end{minipage}50 51 \vfill52 53 \begin{center}54 \Large55 \href{http://www.cmcc.it }{ \includegraphics[height=1cm]{logos/CMCC} } \hspace{0.25cm}56 \href{http://www.cnrs.fr }{ \includegraphics[height=1cm]{logos/CNRS} } \hspace{0.25cm}57 \href{http://www.mercator-ocean.fr}{ \includegraphics[height=1cm]{logos/MOI} } \hspace{0.25cm}58 \href{http://www.metoffice.gov.uk }{ \includegraphics[height=1cm]{logos/UKMO} } \hspace{0.25cm}59 \href{http://nerc.ukri.org }{ \includegraphics[height=1cm]{logos/NERC} } \\60 \medskip61 \slshape62 {C}ommunity \hspace{1.5em} {O}cean \hspace{1.5em} {M}odel \\63 \end{center}64 65 \end{titlepage}66 67 \restoregeometry -
NEMO/trunk/doc/latex/global/highlighting.tex
r11572 r12377 2 2 %% ============================================================================== 3 3 4 \usepackage[outputdir=../build , chapter, newfloat]{minted}4 \usepackage[outputdir=../build]{minted} 5 5 6 6 %% Global highlighting style 7 7 \definecolor{bg}{HTML}{f8f8f8} 8 8 \usemintedstyle{emacs} 9 \setminted{bgcolor=bg, fontsize=\scriptsize, breaklines }9 \setminted{bgcolor=bg, fontsize=\scriptsize, breaklines, frame=leftline} 10 10 \setminted[xml]{style=borland} %% Specific per language 11 11 … … 22 22 23 23 %% File 24 \newmintedfile[forfile]{fortran}{} 24 \newmintedfile[forfile]{fortran}{} % \forfile{../namelists/nam...} 25 25 26 26 %% Inline 27 \newmintinline[forcode]{fortran}{ bgcolor=, fontsize=auto} % \forcode{...}28 \newmintinline[xmlcode]{xml}{ bgcolor=, fontsize=auto} % \xmlcode{...}29 \newmintinline[snippet]{console}{ bgcolor=, fontsize=auto} % \snippet{...}27 \newmintinline[forcode]{fortran}{fontsize=auto, frame=lines} % \forcode{...} 28 \newmintinline[xmlcode]{xml}{ fontsize=auto, frame=lines} % \xmlcode{...} 29 \newmintinline[snippet]{console}{fontsize=auto, frame=lines} % \snippet{...} 30 30 31 31 %% Namelists inclusion 32 32 \newcommand{\nlst}[1]{\forfile{../../../namelists/#1}} 33 -
NEMO/trunk/doc/latex/global/index.ist
r11584 r12377 1 1 headings_flag 1 2 heading_prefix "\\medskip\\hfill\\textnormal{" 3 heading_suffix "}\\hfill\\smallskip\n" 2 heading_prefix "{\\medskip\\hfill\\large\\textsf{\\textbf{" 3 heading_suffix "}}\\hfill}\\medskip\\nopagebreak\n" 4 4 5 delim_0 "\\dotfill~" 6 delim_1 "\\dotfill~" 7 delim_2 "\\dotfill~" 8 -
NEMO/trunk/doc/latex/global/info_page.tex
r11515 r12377 2 2 \thispagestyle{plain} 3 3 4 % %================================================================5 % %Disclaimer6 % %================================================================4 % ================================================================ 5 % Disclaimer 6 % ================================================================ 7 7 \subsubsection*{Disclaimer} 8 8 9 9 Like all components of the modelling framework, 10 the \engine \core engine is developed under the \href{http://www.cecill.info}{CECILL license},11 which is a French adaptation of the GNU GPL ( \textbf{G}eneral \textbf{P}ublic \textbf{L}icense).10 the \engine~core engine is developed under the \href{http://www.cecill.info}{CECILL license}, 11 which is a French adaptation of the GNU GPL (General Public License). 12 12 Anyone may use it freely for research purposes, and is encouraged to 13 communicate back to the developmentteam its own developments and improvements.13 communicate back to the NEMO team its own developments and improvements. 14 14 15 15 The model and the present document have been made available as a service to the community. … … 18 18 Users are encouraged to bring them to our attention. 19 19 20 The authors assume no responsibility for problems, errors, or incorrect usage of \NEMO.20 The authors assume no responsibility for problems, errors, or incorrect usage of NEMO. 21 21 22 % %================================================================23 % %External resources24 % %================================================================22 % ================================================================ 23 % External resources 24 % ================================================================ 25 25 \subsubsection*{Other resources} 26 \label{resources}27 26 28 27 Additional information can be found on: 29 28 \begin{itemize} 30 \item \faWordpress\the \href{http://www.nemo-ocean.eu}{website} of the project detailing several29 \item the \href{http://www.nemo-ocean.eu}{website} of the project detailing several 31 30 associated applications and an exhaustive users bibliography 32 \item \faCodeFork\ the \href{http://forge.ipsl.jussieu.fr/nemo}{development platform} of 33 the model with the code repository for the shared reference and some main resources 34 (wiki, ticket system, forums, \ldots) \\ 35 \faGithub\ the \href{http://github.com/NEMO-ocean/NEMO-examples} 36 {repository of the demonstration cases} for research or training 37 \item \faCloudDownload\ the \href{http://zenodo.org/communities/nemo-ocean}{online archive} 38 delivering the publications issued by the consortium (manuals, reports, datasets, \ldots) 39 \item \faEnvelope\ two mailing lists: 31 \item the \href{http://forge.ipsl.jussieu.fr/nemo}{development platform} of the model with 32 the code repository and some main resources (wiki, ticket system, forums, \ldots) 33 \item the \href{http://zenodo.org/communities/nemo-ocean}{online archive} 34 delivering the publications issued by the consortium 35 \item two mailing lists: 40 36 the \href{http://listes.ipsl.fr/sympa/info/nemo-newsletter}{newsletter} for 41 37 top-down communications from the project … … 45 41 \end{itemize} 46 42 47 % %================================================================48 % %Citation49 % %================================================================43 % ================================================================ 44 % Citation 45 % ================================================================ 50 46 \subsubsection*{Citation} 51 47 52 48 Reference for papers and other publications is as follows: 53 49 54 \ medskip50 \vspace{0.5cm} 55 51 56 \begin{sloppypar} 57 ``{\bfseries \heading}\ifdef{\subheading}{ -- \subheading}{}'', 58 {\em Scientific Notes of Climate Modelling Center}, \textbf{\ipslnum} --- ISSN 1288-1619, 59 Institut Pierre-Simon Laplace (IPSL), 60 \href{https://doi.org/10.5281/zenodo.\zid}{doi:10.5281/zenodo.\zid} 61 \end{sloppypar} 52 %% \sloppy: workaround for breaking DOI URL 53 \sloppy 54 ``{\bfseries \heading}'', 55 \firstauthor and \secondauthor, 56 {\em Scientific Notes of Climate Modelling Center}, \textbf{\ipslnum} --- ISSN 1288-1619, 57 Institut Pierre-Simon Laplace (IPSL), 58 \href{https://doi.org/10.5281/zenodo.\zid}{doi:10.5281/zenodo.\zid} 62 59 63 60 \begin{figure}[b] 64 \begin{minipage}[c]{0.7\textwidth} 65 \small 66 \ttfamily{ 67 Scientific Notes of Climate Modelling Center \\ 68 ISSN 1288-1619 \\ 61 \begin{minipage}[c]{0.72\textwidth} 62 \small\ttfamily{Scientific Notes of Climate Modelling Center \\ 63 ISSN 1288-1619 \\ 69 64 Institut Pierre-Simon Laplace (IPSL) 70 65 } … … 75 70 \end{minipage} 76 71 \end{figure} 72 -
NEMO/trunk/doc/latex/global/new_cmds.tex
r11693 r12377 2 2 %% ============================================================================== 3 3 4 %% Same slanted font for NEMO and its core engines 5 \newcommand{\NEMO }{\textsl{NEMO}} 6 \newcommand{\OPA }{\textsl{OPA}} 7 \newcommand{\SIcube}{\textsl{SI$^3$}} 8 \newcommand{\TOP }{\textsl{TOP}} 9 \newcommand{\PISCES}{\textsl{PISCES}} 10 \newcommand{\NEMOVAR}{\textsl{NEMOVAR}} 4 %% Include references and index for compilation of single subfile 5 \newcommand{\mtoc}{\minitoc} 6 \newcommand{\biblio}{\bibliography{../main/bibliography}} 7 \newcommand{\pindex}{\printindex} 11 8 12 %% Links for external components 13 \newcommand{\AGRIF}{\href{http://agrif.imag.fr}{AGRIF}} 14 \newcommand{\CICE }{\href{http://github.com/CICE-Consortium/CICE}{CICE}} 15 \newcommand{\OASIS}{\href{http://portal.enes.org/oasis}{OASIS}} 16 \newcommand{\XIOS }{\href{http://forge.ipsl.jussieu.fr/ioserver}{XIOS}} 17 18 %% Fortran in small capitals 19 \newcommand{\fortran}{\textsc{Fortran}} 20 \newcommand{\fninety}{\textsc{Fortran 90}} 9 %% NEMO and Fortran in small capitals 10 \newcommand{\NEMO}{\textsc{nemo}~} 11 \newcommand{\fortran}{\textsc{Fortran}~} 12 \newcommand{\fninety}{\textsc{Fortran 90}~} 21 13 22 14 %% Common aliases … … 26 18 \newcommand{\ztilde}{\ensuremath{\tilde z}} 27 19 \newcommand{\stilde}{\ensuremath{\tilde s}} 28 \newcommand{\ie}{\ensuremath{i.e.} }29 \newcommand{\eg}{\ensuremath{e.g.} }20 \newcommand{\ie}{\ensuremath{i.e.}~} 21 \newcommand{\eg}{\ensuremath{e.g.}~} 30 22 31 23 %% Inline maths … … 33 25 \newcommand{\rdt}{\Delta t} 34 26 35 %% Gurvan's comments36 \newcommand{\ cmtgm}[1]{}27 %% Text env. for Gurvan 28 \newcommand{\gmcomment}[1]{} 37 29 38 30 %% Maths 39 31 \newcommand{\lt}{\left} 40 32 \newcommand{\rt}{\right} 41 \newcommand{\vect}[1]{\ensuremath{ \mathbf{#1}}}33 \newcommand{\vect}[1]{\ensuremath{\mathbf{#1}}} 42 34 \newcommand{\pd}[2][]{\ensuremath{\frac{\partial #1}{\partial #2}}} 43 35 44 %% Convert chapter/section headings to lowercase 45 \renewcommand{\chaptermark}[1]{\markboth{#1}{}} 46 \renewcommand{\sectionmark}[1]{\markright{#1}{}} 47 48 %% Retrieve month name 49 \renewcommand{\today}{ 50 \ifcase \month\or January\or February\or March\or 51 April\or May\or June\or 52 July\or August\or September\or 53 October\or November\or December 54 \fi, \number \year 55 } 56 57 %% Link to orcid profile 58 \newcommand{\orcid}[1]{\href{http://orcid.org/#1}{\textcolor{orcidcolor}\aiOrcidSquare}} 59 60 %% Workaround for \listoffigures 61 \DeclareRobustCommand{\triad}[6][]{\ensuremath{ {}_{#2}^{#3} { \mathbb{#4}_{#1} }_{#5}^{\,#6} }} 62 63 %% New command for ToC 64 \newcommand{\chaptertoc}[1][Table of contents]{% 65 \thispagestyle{empty} 66 \etocsettocstyle{\addsec*{#1}}{}% 67 \localtableofcontents% 68 \vfill 69 } 36 %% Workaround for issue with \listoffigures 37 \DeclareRobustCommand{\triad}[6][]{\ensuremath{{}_{#2}^{#3}{\mathbb{#4}_{#1}}_{#5}^{\,#6}}} -
NEMO/trunk/doc/latex/global/packages.tex
r11702 r12377 3 3 %% ============================================================================== 4 4 5 %% 'hyperref' pkg is loaded at the end of the preamble for higher compatibility 5 \usepackage{natbib} %% bib 6 \usepackage{caption} %% caption 7 \usepackage{xcolor} %% color 8 \usepackage{times} %% font 9 \usepackage{enumitem} %% list 10 \usepackage{amsmath} %% maths 11 %\usepackage{fancyhdr} %% page 12 \usepackage{minitoc} %% toc 13 \usepackage{subfiles} %% subdocs 14 \usepackage{draftwatermark} %% watermark 15 \usepackage{titling} %% titlepage 6 16 7 %% KOMA-script 8 \usepackage[footsepline=0.25pt, headsepline=0.25pt]{scrlayer-scrpage} 9 10 %% customization (layout, header/footer styles & contents, background) 11 \usepackage{draftwatermark} 12 \usepackage[margin = 2cm]{geometry} 13 \usepackage[pages = some]{background} %% 'some' for title page 14 \usepackage[Bjornstrup]{fncychap} 15 16 %% Fonts 17 \usepackage{fontspec} 18 %% Issue with fontawesome pkg: path to FontAwesome.otf has to be hard-coded 19 \defaultfontfeatures{ 20 Path = /usr/local/texlive/2019/texmf-dist/fonts/opentype/public/fontawesome/ 21 } 22 \usepackage{academicons, fontawesome, newtxtext} 23 24 %% Formatting 25 \usepackage[inline]{enumitem} 26 \usepackage{etoc, tabularx, xcolor} 27 28 %% Graphics 29 \usepackage{caption, graphicx, grffile} 30 31 %% Labels 32 \usepackage{lastpage, natbib} 33 34 %% Mathematics 35 \usepackage{amsmath, amssymb, mathtools} 36 37 %% Versatility 38 \usepackage{subfiles} 17 %% Extensions in bundle package 18 \usepackage{amssymb, graphicx, tabularx, textcomp} 19 \usepackage[utf8]{inputenc} %% input encoding 39 20 40 21 %% Configuration 41 \graphicspath{ {../../../} {../figures/} } 22 \graphicspath{ {../../figures/} {../../figures/\engine/} } 23 %\captionsetup{margin=10pt, font={small}, labelsep=colon, labelfont={bf}} 24 \renewcommand{\bibfont}{\small} 25 %\renewcommand{\bibsep}{3pt} 42 26 43 %% Missing utmr8a font44 \usepackage{times} -
NEMO/trunk/doc/latex/global/styles.tex
r11687 r12377 3 3 %% ============================================================================== 4 4 5 %% Colors 6 \setmanualcolor 7 \colorlet{manualcolorshaded}{manualcolor!60} 8 \definecolor{orcidcolor}{HTML}{A6CE39} 5 %\pagestyle{fancy} 6 \bibliographystyle{../../global/ametsoc} 7 \renewcommand{\bibpreamble}{\begin{multicols}{2}} 8 \renewcommand{\bibpostamble}{\end{multicols}} 9 10 %% Additional fonts 11 \DeclareMathAlphabet{\mathpzc}{OT1}{pzc}{m}{it} 9 12 10 13 %% Page layout 11 \pagestyle{scrheadings} 12 \addtokomafont{pagehead}{ \sffamily } 13 \addtokomafont{pagefoot}{ \sffamily \footnotesize} 14 \addtokomafont{pagenumber}{\sffamily \slshape } 15 \addtokomafont{chapter}{\color{white}} 16 \ohead{} \ofoot{} %% Clear defaults 14 %\fancyhf{} 15 %\fancyhead[LE,RO]{\bfseries\thepage} 16 %\fancyhead[LO]{\bfseries\hspace{-0em}\rightmark} 17 %\renewcommand{\sectionmark}[1]{\markright{\thesection.\ #1}} 18 %\fancyhead[RE]{\bfseries\leftmark} 19 %\renewcommand{\chaptermark}[1]{\markboth{#1}{}} 20 %\renewcommand{\headrulewidth}{0.5pt} 21 %\renewcommand{\footrulewidth}{0pt } 22 %\addtolength{\headheight}{2.6pt} 17 23 18 %% Caption19 \captionsetup{font = footnotesize, justification = justified}20 21 %% Footnote22 \renewcommand{\thefootnote}{\fnsymbol{footnote}}23 24 %% Bibliography25 \bibliographystyle{../../global/ametsoc}26 \renewcommand{\bibfont}{\small}27 \renewcommand{\bibpreamble }{\begin{multicols}{2}}28 \renewcommand{\bibpostamble}{ \end{multicols} }29 24 30 25 %% Catcodes 31 \makeatletter 26 %\makeatletter 27 %\def\LigneVerticale{\vrule height 5cm depth 2cm\hspace{0.1cm}\relax} 28 %\def\LignesVerticales{\let\LV\LigneVerticale\LV\LV\LV\LV\LV\LV\LV\LV\LV\LV} 29 %\def\GrosCarreAvecUnChiffre#1{ 30 % \rlap{\vrule height 0.8cm width 1cm depth 0.2cm} 31 % \rlap{\hbox to 1cm{\hss\mbox{\color{white} #1}\hss}} 32 % \vrule height 0pt width 1cm depth 0pt 33 %} 34 %\def\@makechapterhead#1{ 35 % \hbox{ 36 % \huge\LignesVerticales\hspace{-0.5cm} 37 % \GrosCarreAvecUnChiffre{\thechapter}\hspace{0.2cm} 38 % \hbox{#1} 39 % } 40 % \par\vskip 41 %1cm 42 %} 43 %\def\@makeschapterhead#1{ 44 % \hbox{ 45 % \huge\LignesVerticales 46 % \hbox{#1} 47 % } 48 % \par\vskip 49 %2cm 50 %} 51 %\def\cleardoublepage{\clearpage\if@twoside \ifodd\c@page\else 52 % \hbox{} 53 % \vspace*{\fill} 54 % \vspace{\fill} 55 % \thispagestyle{empty} 56 % \newpage 57 % \if@twocolumn\hbox{}\newpage\fi\fi\fi} 58 %\def\@seccntformat#1{\protect\makebox[0pt][r]{\csname the#1\endcsname\quad}} 59 %\makeatother 32 60 33 %% Prevent error with tikz and namelist inclusion34 \global\let\tikz@ensure@dollar@catcode=\relax35 61 36 %% First page37 \backgroundsetup{38 firstpage = true,39 scale = 1, angle = 0, opacity = 1,40 contents = {41 \begin{tikzpicture}[remember picture, overlay]42 \path [fill = manualcolor] (-0.5\paperwidth, 7) rectangle (0.5\paperwidth, 10);43 \end{tikzpicture}44 }45 }46 47 %% Apply engine color for chapter headings: tweaking snippets from fncychap.sty48 \renewcommand{\DOCH}{%49 \settowidth{\py}{\CNoV\thechapter}50 \addtolength{\py}{-10pt} % Amount of space by which the51 % % number is shifted right52 \fboxsep=0pt%53 \colorbox{manualcolor}{\rule{0pt}{40pt}\parbox[b]{\textwidth}{\hfill}}%54 \kern-\py\raise20pt%55 \hbox{\color{manualcolorshaded}\CNoV\thechapter}\\%56 }57 \renewcommand{\DOTI}[1]{%58 \nointerlineskip\raggedright%59 \fboxsep=\myhi%60 \vskip-1ex%61 \colorbox{manualcolor}{\parbox[t]{\mylen}{\color{white}\CTV\FmTi{#1}}}\par\nobreak%62 \vskip 40\p@%63 }64 \renewcommand{\DOTIS}[1]{%65 \fboxsep=0pt66 \colorbox{manualcolor}{\rule{0pt}{40pt}\parbox[b]{\textwidth}{\hfill}}\\%67 \nointerlineskip\raggedright%68 \fboxsep=\myhi%69 \vskip-1ex% Remove white 1pt line70 \colorbox{manualcolor}{\parbox[t]{\mylen}{\color{white}\CTV\FmTi{#1}}}\par\nobreak%71 \vskip 40\p@%72 }73 74 %% Temporary fix75 \def\set@curr@file#1{%76 \begingroup77 \escapechar\m@ne78 \xdef\@curr@file{\expandafter\string\csname #1\endcsname}%79 \endgroup80 }81 \def\quote@name#1{"\quote@@name#1\@gobble""}82 \def\quote@@name#1"{#1\quote@@name}83 \def\unquote@name#1{\quote@@name#1\@gobble"}84 85 \makeatother
Note: See TracChangeset
for help on using the changeset viewer.