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 9407 for branches/2017/dev_merge_2017/DOC/tex_sub/chap_OBS.tex – NEMO

Ignore:
Timestamp:
2018-03-15T17:40:35+01:00 (6 years ago)
Author:
nicolasmartin
Message:

Complete refactoring of cross-referencing

  • Use of \autoref instead of simple \ref for contextual text depending on target type
  • creation of few prefixes for marker to identify the type reference: apdx|chap|eq|fig|sec|subsec|tab
File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/2017/dev_merge_2017/DOC/tex_sub/chap_OBS.tex

    r9394 r9407  
    55% ================================================================ 
    66\chapter{Observation and Model Comparison (OBS)} 
    7 \label{OBS} 
     7\label{chap:OBS} 
    88 
    99Authors: D. Lea, M. Martin, K. Mogensen, A. Vidard, A. Weaver, A. Ryan, ...   % do we keep that ? 
     
    4242details on setting up the namelist. 
    4343 
    44 Section~\ref{OBS_example} introduces a test example of the observation operator code including 
    45 where to obtain data and how to setup the namelist. Section~\ref{OBS_details} introduces some 
     44\autoref{sec:OBS_example} introduces a test example of the observation operator code including 
     45where to obtain data and how to setup the namelist. \autoref{sec:OBS_details} introduces some 
    4646more technical details of the different observation types used and also shows a more complete 
    47 namelist. Section~\ref{OBS_theory} introduces some of the theoretical aspects of the observation 
     47namelist. \autoref{sec:OBS_theory} introduces some of the theoretical aspects of the observation 
    4848operator including interpolation methods and running on multiple processors. 
    49 Section~\ref{OBS_ooo} describes the offline observation operator code. 
    50 Section~\ref{OBS_obsutils} introduces some utilities to help working with the files 
     49\autoref{sec:OBS_ooo} describes the offline observation operator code. 
     50\autoref{sec:OBS_obsutils} introduces some utilities to help working with the files 
    5151produced by the OBS code. 
    5252 
     
    5555% ================================================================ 
    5656\section{Running the observation operator code example} 
    57 \label{OBS_example} 
     57\label{sec:OBS_example} 
    5858 
    5959This section describes an example of running the observation operator code using 
     
    9999Setting \np{ln\_grid\_global} means that the code distributes the observations 
    100100evenly between processors. Alternatively each processor will work with 
    101 observations located within the model subdomain (see section~\ref{OBS_parallel}). 
     101observations located within the model subdomain (see section~\autoref{subsec:OBS_parallel}). 
    102102 
    103103A number of utilities are now provided to plot the feedback files, convert and 
    104 recombine the files. These are explained in more detail in section~\ref{OBS_obsutils}. 
     104recombine the files. These are explained in more detail in section~\autoref{sec:OBS_obsutils}. 
    105105Utilites to convert other input data formats into the feedback format are also  
    106 described in section~\ref{OBS_obsutils}. 
     106described in section~\autoref{sec:OBS_obsutils}. 
    107107 
    108108\section{Technical details (feedback type observation file headers)} 
    109 \label{OBS_details} 
     109\label{sec:OBS_details} 
    110110 
    111111Here we show a more complete example namelist  \ngn{namobs} and also show the NetCDF headers 
     
    545545 
    546546\section{Theoretical details} 
    547 \label{OBS_theory} 
     547\label{sec:OBS_theory} 
    548548 
    549549\subsection{Horizontal interpolation and averaging methods} 
     
    683683\end{itemize} 
    684684 
    685 Examples of the weights calculated for an observation with rectangular and radial footprints are shown in Figs.~\ref{fig:obsavgrec} and~\ref{fig:obsavgrad}. 
     685Examples of the weights calculated for an observation with rectangular and radial footprints are shown in Figs.~\autoref{fig:obsavgrec} and~\autoref{fig:obsavgrad}. 
    686686 
    687687%>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     
    768768 
    769769\subsection{Parallel aspects of horizontal interpolation} 
    770 \label{OBS_parallel} 
     770\label{subsec:OBS_parallel} 
    771771 
    772772For horizontal interpolation, there is the basic problem that the 
     
    794794 
    795795This is the simplest option in which the observations are distributed according  
    796 to the domain of the grid-point parallelization. Figure~\ref{fig:obslocal} 
     796to the domain of the grid-point parallelization. \autoref{fig:obslocal} 
    797797shows an example of the distribution of the {\em in situ} data on processors  
    798798with a different colour for each observation 
     
    823823among processors and use message passing in order to retrieve  
    824824the stencil for interpolation. The simplest distribution of the observations  
    825 is to distribute them using a round-robin scheme. Figure~\ref{fig:obsglobal} 
     825is to distribute them using a round-robin scheme. \autoref{fig:obsglobal} 
    826826shows the distribution of the {\em in situ} data on processors for the 
    827827round-robin distribution of observations with a different colour for 
    828828each observation on a given processor for a 4 $\times$ 2 decomposition  
    829 with ORCA2 for the same input data as in Fig.~\ref{fig:obslocal}. 
     829with ORCA2 for the same input data as in \autoref{fig:obslocal}. 
    830830The observations are now clearly randomly distributed on the globe. 
    831831In order to be able to perform horizontal interpolation in this case,  
     
    850850 
    851851\section{Offline observation operator} 
    852 \label{OBS_ooo} 
     852\label{sec:OBS_ooo} 
    853853 
    854854\subsection{Concept} 
     
    11831183 
    11841184\section{Observation utilities} 
    1185 \label{OBS_obsutils} 
     1185\label{sec:OBS_obsutils} 
    11861186 
    11871187Some tools for viewing and processing of observation and feedback files are provided in the 
     
    13541354\end{minted} 
    13551355 
    1356 Fig~\ref{fig:obsdataplotmain} shows the main window which is launched when dataplot starts. 
     1356\autoref{fig:obsdataplotmain} shows the main window which is launched when dataplot starts. 
    13571357This is split into three parts. At the top there is a menu bar which contains a variety of 
    13581358drop down menus. Areas - zooms into prespecified regions; plot - plots the data as a 
     
    13891389 
    13901390If a profile point is clicked with the mouse button a plot of the observation and background 
    1391 values as a function of depth (Fig~\ref{fig:obsdataplotprofile}). 
     1391values as a function of depth (\autoref{fig:obsdataplotprofile}). 
    13921392 
    13931393%>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
Note: See TracChangeset for help on using the changeset viewer.