htgop_doc

Documentation of the htgop file format
git clone git://git.meso-star.com/htgop_doc.git
Log | Files | Refs | README | LICENSE

gas_opt_prop_fr.tex (12007B)


      1 % Copyright (C) 2026 |Méso|Star> (contact@meso-star.com)
      2 %
      3 % Ce fichier fait partie de HTGOP doc.
      4 %
      5 % HTGOP doc est un logiciel libre ; vous pouvez le redistribuer ou le
      6 % modifier suivant les termes de la GNU General Public License telle
      7 % que publiée par la Free Software Foundation ; soit la version 3 de
      8 % la licence, soit (à votre gré) toute version ultérieure.
      9 %
     10 % HTGOP doc est distribué dans l'espoir qu'il sera utile, mais SANS
     11 % AUCUNE GARANTIE ; sans même la garantie tacite de QUALITÉ MARCHANDE
     12 % ou d'ADÉQUATION à UN BUT PARTICULIER. Consultez la GNU General
     13 % Public License pour plus de détails.
     14 %
     15 % Vous devez avoir reçu une copie de la GNU General Public License en
     16 % même temps que HTGOP doc ; si ce n'est pas le cas, consultez
     17 % <http://www.gnu.org/licenses>.
     18 
     19 \documentclass[12pt]{article}
     20 \usepackage[utf8]{inputenc}
     21 \usepackage[T1]{fontenc}
     22 \usepackage[french]{babel}
     23 \usepackage{graphics}
     24 \usepackage{subfigure}
     25 \usepackage{hyperref}
     26 \usepackage{graphicx}
     27 \usepackage{listings}
     28 \makeatletter
     29 
     30 % double spacing lines
     31 \renewcommand{\baselinestretch}{1}
     32 \newcommand{\LyX}{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\spacefactor1000}
     33 
     34 %pour faire reference toujours avec la meme norme
     35 %lyx !
     36 \newcommand{\eq}[1]{Eq.~\ref{eq:#1}}
     37 \newcommand{\fig}[1]{Fig.~\ref{fig:#1}}
     38 \newcommand{\tab}[1]{Tab.~\ref{tab:#1}}
     39 \newcommand{\para}[1]{Sec.~\ref{para:#1}}
     40 \newcommand{\ap}[1]{Appendix~\ref{ap:#1}}
     41 \newcommand{\ul}{\underline}
     42 %
     43 \makeatother
     44 
     45 % margins
     46 \setlength{\topmargin}{-0.75in}
     47 \setlength{\textheight}{9in}
     48 \setlength{\oddsidemargin}{-.50in}
     49 \setlength{\textwidth}{7.5in}
     50 
     51 \begin{document}
     52 
     53 \title{High-Tune: gas optical properties file format}
     54 
     55 \maketitle
     56 \begin{center}
     57 \author{\bf|Méso|Star>}\\
     58  (\url{http://www.meso-star.com}) \\
     59 \end{center}
     60 \vspace{1cm}
     61 
     62 \tableofcontents
     63 
     64 \newpage
     65 \section{Contexte}
     66 Ce document présente le format de fichier fournissant toutes les données permettant de calculer les propriétés optiques (coefficients d'absorption et de diffusion, LW \& SW) {\bf du mélange gazeux} uniquement.
     67 Le fichier de données utilise le format ASCII, et la convention suivante: chaque donnée est décrite par une ligne de commentaire, suivie par la donnée numérique. Une seule valeur numérique est donnée par ligne. Les valeurs numériques d'un tableau de dimension $N$ sont donc fournies sur $N$ lignes.
     68 
     69 \section{Description du modèle et utilisation des données}
     70 
     71 Les données fournies dans ce fichier concernent une atmosphère plan-parallèle stratifiée: l'atmosphère est divisée en $N_{lev}$ niveaux (de pression, ou d'altitude) délimitant $N_{lay}=N_{lev}-1$ mailles. Un certain nombre de données sont fournies pour les niveaux, d'autres sont fournies pour les mailles (hypothèse de maille homogène, ce qui revient à fournir pour les mailles une donnée moyenne). Enfin, il existe deux grand domaines spectraux: le longwave (LW) et le shortwave (SW). Pour chacun de ces domaines, un certain nombre d'intervalles est défini. Enfin, dans chacun de ces intervalles, un certain nombre de points de quadrature est défini (différent dans chaque intervalle).
     72 
     73 \begin{figure}[!h]
     74 \centering
     75 \includegraphics[width=0.80\textwidth,angle=0]{./figures/ka_lw.pdf}
     76 \caption[]{Evolution du coefficient d'absorption pour les dix points de quadrature du premier intervalle spectral LW, pour la première maille atmosphérique (profil MLS) en fonction de la concentration molaire de vapeur d'eau.}
     77 \label{fig:ka_lw}
     78 \end{figure}
     79 
     80 La principale chose à retenir est la possibilité de reconstruire les propriétés optiques du mélange de gaz (coefficients d'absorption et de diffuion) à partir des données fournies dans ce fichier atmosphérique, ainsi que de la composition locale en vapeur d'eau (variable, imposée par les données LES). Le fichier atmosphérique contient en effet les valeurs des coefficients d'absorption et de diffusion tabulés en fonction de la fraction molaire de vapeur d'eau $x_{H_{2}O}$. On peut en effet constater (figure \ref{fig:ka_lw}) que le logarithme du coefficient d'absorption évolue de façon linéaire avec le logarithme de $x_{H_{2}O}$ sur une large gamme de concentration molaire, et ce pour chaque point de quadrature. Il est donc facile d'interpoler les propriétés optiques du mélange de gaz pour toute valeur de $x_{H_{2}O}(local)$ (imposée, dans le cas du projet High-Tune, par les données nuageuses LES) à partir des valeurs tabulés dans le fichier atmosphérique.
     81 
     82 \begin{figure}[htbp]
     83 %  \hspace*{-2.2cm}
     84   \centering
     85   \mbox{
     86     \subfigure[]{
     87       \includegraphics[width=0.50\textwidth]{./figures/si_flux_nominal_lw.pdf}
     88     }
     89     \quad
     90     \hspace{-0.5cm}
     91     \subfigure[]{
     92       \includegraphics[width=0.50\textwidth]{./figures/dsi_flux_lw.pdf}
     93     }
     94   }
     95   \caption{(a) Profil de flux intégrés sur le domaine LW, obtenus à l'aide des épaisseurs optiques d'absorption nominales de ECRAD sur un profil standard MLS; (b) Ecart sur les flux radiatif (intégrés sur le domaine LW) obtenus d'une part à l'aide des épaisseurs optiques d'absorption nominales, et d'autre part à l'aide des épaisseurs optiques d'absorption interpolées à partir de la tabulation et des valeurs nominales de $x_{H_{2}O}$}
     96   \label{fig:si_flux_lw}
     97 \end{figure}
     98 
     99 \begin{figure}[htbp]
    100 %  \hspace*{-2.2cm}
    101   \centering
    102   \mbox{
    103     \subfigure[]{
    104       \includegraphics[width=0.50\textwidth]{./figures/si_flux_nominal_sw.pdf}
    105     }
    106     \quad
    107     \hspace{-0.5cm}
    108     \subfigure[]{
    109       \includegraphics[width=0.50\textwidth]{./figures/dsi_flux_sw.pdf}
    110     }
    111   }
    112   \caption{(a) Profil de flux intégrés sur le domaine SW, obtenus à l'aide des épaisseurs optiques d'absorption nominales de ECRAD sur un profil standard MLS; (b) Ecart sur les flux radiatif (intégrés sur le domaine SW) obtenus d'une part à l'aide des épaisseurs optiques d'absorption nominales, et d'autre part à l'aide des épaisseurs optiques d'absorption interpolées à partir de la tabulation et des valeurs nominales de $x_{H_{2}O}$}
    113   \label{fig:si_flux_sw}
    114 \end{figure}
    115 
    116 
    117 Un travail de validation de l'hypothèse de linéarité des propriétés optiques avec la fraction molaire de vapeur d'eau a été conduit sur la base suivante: nous disposons d'un code de transfert radiatif (LW \& SW) basé sur l'utilisation de solutions analytiques, donc sans diffusion (en cours de publication) qui a été adapté à l'utilisation de données spectrales en k-distribution à ordre de quadrature variable, donc permettant d'utiliser les données spectrales issues de ECRAD. Nous avons effectué deux calculs de transfert radiatif (flux intégrés sur le domaine LW) sur un profil atmosphérique MLS modifié: dans un premier temps, nous avons isolé dans les données LES, la colonne contenant la maille présentant la plus forte humidité spécifique. Le profil vertical de $x_{H_{2}O}$ du profil MLS standard a donc été remplacé, dans chaque maille atmosphérique, par les données issues de cette colonne LES dans la zone contenant le nuage (pour z<4 km), et n'a pas été modifié en dehors de cette zone. Les deux calculs de transfert radiatif effectués ont utilisé:
    118 
    119 \begin{itemize}
    120 \item d'une part, les coefficients d'absorption issus de ECRAD pour le profil MLS modifié. Les résultats sont présentés en figure \ref{fig:si_flux_lw}(a) pour le LW et en figure \ref{fig:si_flux_sw}(a) pour le SW.
    121 \item d'autre part en utilisant les coefficient d'absorption obtenus par interpolation à partir des valeurs locales de $x_{H_{2}O}$, et de la tabulation établie par utilisation de ECRAD, sur 20 points $x_{H_{2}O}$ répartis de façon uniforme en log entre 10$^{-6}$ et 1. La figure \ref{fig:si_flux_lw}(b) montre les différences entre les flux radiatifs obtenus par cette méthode et les résultats précédents (référence) pour le LW, et la figure \ref{fig:si_flux_sw}(b) montre les mêmes écarts pour le domaine SW.
    122 \end{itemize}
    123 
    124 Les résultats étant extrêmement proches, on considère à cette étape que la méthodologie consistant à tabuler les propriétés optiques du mélange en fonction de $x_{H_{2}O}$ dans le but d'interpoler ces quantités pour n'importe quelle valeur locale de $x_{H_{2}O}$, est bien validée. Au besoin, il est possible de rajouter des données dans la tabulation afin d'améliorer la précision sur le transfert radiatif.
    125 
    126 \newpage
    127 \section{Format de fichier}
    128 
    129 Les données fournies dans le fichier atmosphérique, séparées par une ligne de commentaire, sont les suivantes:
    130 
    131 \begin{itemize}
    132 \item Le nombre de niveaux atmosphériques $N_{lev}$ (1 entier)
    133 \item Le nombre de mailles atmosphériques $N_{lay}$ (1 entier)
    134 \item La température du sol (1 réel) [K]
    135 \item La pression à chaque niveau ($N_{lev}$ réels) [Pa]
    136 \item La température à chaque niveau ($N_{lev}$ réels) [K]
    137 \item L'altitude à chaque niveau ($N_{lev}$ réels) [m]
    138 \item La fraction molaire nominale de vapeur d'eau dans le mélange $x_{H_{2}O}(nominal)$, pour chaque maille ($N_{lay}$ réels) [mole de $H_{2}O$ par mole de mélange]
    139 \item Le nombre de profils verticaux de fraction molaire de vapeur d'eau $x_{H_{2}O}$ pour la tabulation ($N_{w}$).
    140 \item Pour chacun des $N_{w}$ profils verticaux de $x_{H_{2}O}$ de la tabulation: la valeur de $x_{H_{2}O}$ pour chacune des $N_{lay}$ mailles atmosphériques. ($N_{w}xN_{lay} réels$) [mole de $H_{2}O$ par mole de mélange]
    141 \item L'émissivité du sol pour le domaine LW (1 réel)
    142 \item L'émissivité du sol pour le domaine SW (1 réel)
    143 \item Le nombre d'intervalles spectraux pour le domaine LW $N_{b,LW}$ (1 entier)
    144 \item Le nombre d'intervalles spectraux pour le domaine SW $N_{b,SW}$ (1 entier)
    145 \item Pour chacun des $i_{b} \in [1,N_{b,LW}]$ intervalles du domaine LW:
    146 \begin{itemize}
    147 \item le nombre d'onde inférieure de l'intervalle (1 réel) [cm$^{-1}$]
    148 \item le nombre d'onde supérieure de l'intervalle (1 réel) [cm$^{-1}$]
    149 \item le nombre de points de quadrature $N_{g}(i_{b})$ (1 entier)
    150 \item les $N_{g}(i_{b})$ poids de quadrature de l'intervalle ($N_{g}(i_{b})$ réels)
    151 \end{itemize}
    152 \item Pour chacun des $i_{b} \in [1,N_{b,SW}]$ intervalles du domaine SW:
    153 \begin{itemize}
    154 \item le nombre d'onde inférieure de l'intervalle (1 réel) [cm$^{-1}$]
    155 \item le nombre d'onde supérieure de l'intervalle (1 réel) [cm$^{-1}$]
    156 \item le nombre de points de quadrature $N_{g}(i_{b})$ (1 entier)
    157 \item les $N_{g}(i_{b})$ poids de quadrature de l'intervalle ($N_{g}(i_{b})$ réels)
    158 \end{itemize}
    159 \item Pour chacun des $i_{b} \in [1,N_{b,LW}]$ intervalles du domaine LW, et pour chacun des $i_{g} \in [1,N_{g}(i_{b})]$ points de quadrature:
    160 \begin{itemize}
    161 \item le coefficient d'absorption {\bf nominal} du mélange de gaz, pour chaque maille ($N_{lay}$ réels) [m$^{-1}$]
    162 \item le coefficient d'absorption du mélange de gaz {\bf pour chaque point de tabulation} $i_{w}$, pour chaque maille ($N_{w}xN_{lay}$ réels) [m$^{-1}$]
    163 \end{itemize}
    164 \item Pour chacun des $i_{b} \in [1,N_{b,SW}]$ intervalles du domaine SW, et pour chacun des $i_{g} \in [1,N_{g}(i_{b})]$ points de quadrature:
    165 \begin{itemize}
    166 \item le coefficient d'absorption {\bf nominal} du mélange de gaz, pour chaque maille ($N_{lay}$ réels) [m$^{-1}$]
    167 \item le coefficient d'absorption du mélange de gaz {\bf pour chaque point de tabulation} $i_{w}$, pour chaque maille ($N_{w}xN_{lay}$ réels) [m$^{-1}$]
    168 \end{itemize}
    169 \item Pour chacun des $i_{b} \in [1,N_{b,SW}]$ intervalles du domaine SW, et pour chacun des $i_{g} \in [1,N_{g}(i_{b})]$ points de quadrature:
    170 \begin{itemize}
    171 \item le coefficient de diffusion {\bf nominal} du mélange de gaz, pour chaque maille ($N_{lay}$ réels) [m$^{-1}$]
    172 \item le coefficient de diffusion du mélange de gaz {\bf pour chaque point de tabulation} $i_{w}$, pour chaque maille ($N_{w}xN_{lay}$ réels) [m$^{-1}$]
    173 \end{itemize}
    174 
    175 \end{itemize}
    176 
    177 Un exemple de routine (fortran) permettant de lire ce fichier est donné ci-dessous (fichier ``input.for''):
    178 
    179 \lstinputlisting[language=fortran]{./source_files/input.for}
    180 
    181 \end{document}