Philippe 02/05/2016: moved all LIBTOOLS files in LIBTOOLS directory
[MNH-git_open_source-lfs.git] / LIBTOOLS / readme / LATEX / conv2dia.tex
1 \section{Conversion of FM synchronous file to diachronic format}
2 Short description is given here, readers must refer to the original documentation on the Meso-NH web site:
3 ``{\sc traitement graphique des fichiers synchrones produits par le mod\`ele
4 mesonh}, J. Duron''. 
5
6 \subsection{Synchronous and diachronic formats} \label{diachro_file}
7 The Meso-NH graphic utility ({\tt diaprog}) works on FM files which are on
8 diachronic format. A diachronic FM file is either
9 \begin{itemize}
10 \item
11 a file produced during the simulation 
12 which contain time series of self-documented informations
13 (e.g. file with name CEXP.1.CSEG.000).
14 An information is one of the following: 
15 \subitem - a
16 3-dimensional, 2-dimensional, 1-dimensional or 0-dimensional field (eventually
17 time-averaged, or compressed in one direction): type {\sc cart}, 
18 \subitem - a set of vertical profiles at points checking some criteria:
19 type {\sc mask}, 
20 \subitem - spectral coefficients obtained by FFT along the X or Y direction:
21 type {\sc spxy},
22 \subitem - pseudo-observations (ground station: type {\sc ssol};
23 dropsonde: type {\sc drst}; radiosonde: type {\sc rspl};
24 airborne radar: type {\sc rapl}).
25  \\
26 A diachronic file can contains informations of one or several previous types
27 stored at different time frequency.
28 For a whole description about the diachronic file type, reader must refer
29 to the original documentation on the Meso-NH web site:
30 ``{\sc cr\'eation et exploitation de fichiers diachroniques}, J. Duron''. 
31 \end{itemize}
32 or
33 \begin{itemize}
34 \item a `pseudo'-diachronic file resulting of the conversion of a synchronous
35 file (e.g. with name CEXP.1.CSEG.00n where n$>$0).
36 Recall that such a file contains all the pronostic fields of the model at one 
37 instant (initial or during the simulation).
38 When converted it is a 'pseudo'-diachronic file, because it contains only one 
39 instant and one type of diachronic information ({\sc cart}).
40 The next subsection presents the conversion tool (named \texttt{conv2dia})
41 to apply to synchronous files, necessary step to use \texttt{diaprog} graphic
42 tool.
43 \end{itemize}
44
45 \subsection{{\tt conv2dia} tool}
46 The conversion tool works on files produced by
47 the initialisation programs ({\sc prep\_pgd, prep\_ideal\_case,
48 prep\_real\_case}), the model simulation, or the post-processing program
49 ({\tt\sc diag}). It allows to convert one synchronous file onto one diachronic 
50 file, as well as merge several synchronous files with chronological times
51 (outputs of one run, or files initialised from large-scale model)
52 onto one diachronic file.
53
54 With {\tt conv2dia.elim} tool, you can choose not to convert all the fields of
55 the input file(s). The pronostic fields at $t-dt$ instant, or at $t$ instant,
56 or any other fields can be eliminated.
57 With {\tt conv2dia.select} tool, you have to indicate the fields to select
58 for conversion.
59 This is done to reduce the size of the output file.
60
61 The output file contains informations whose type is {\sc cart} stored in arrays
62 with size of {\tt (IIU*IJU*IKU), (IIU*IJU), (IIU*IKU),} or 1.
63
64
65 \subsection{Example}
66
67 Only the binary (\textsc{LFI}) part of the input FM files is required
68 in the current directory (split the FM file with the {\tt fm2deslfi} 
69 script if not).
70
71 All characters typed on keyboard are saved in {\tt dirconv.elim} or 
72 {\tt dirconv.select} file, it can be appended and used as input (after being 
73 renamed) for the next call of the tool
74 \newline (e.g.  {\tt conv2dia.elim < dirconv.elim.ex}).
75
76 Below is the example of questions when {\tt conv2dia.elim} is invoked.
77
78 \small
79 \begin{tabular}{l}
80 \\
81 \\
82 {\tt ENTER NUMBER OF INPUT FM FILES}  \\
83 {\tt\it 2 }  \\
84 {\tt ENTER FM FILE NAME}  \\
85 {\tt\it CEXP.1.CSEG.001}  \\
86 {\tt ENTER FM FILE NAME}  \\
87 {\tt\it CEXP.1.CSEG.002}  \\
88 {\tt ENTER DIACHRONIC FILE NAME}  \\
89 {\tt\it CEXP.1.CSEG.1-2.dia}  \\
90 {\tt DELETION OF PARAMETERS AT TIME t-dt ? (enter 1) } \\
91 {\tt DELETION OF PARAMETERS AT TIME t    ? (enter 2) } \\
92 {\tt NO DELETION                         ? (enter 0) } \\
93 {\tt\it 2 }  \\
94 {\tt Do you want to suppress others parameters ? (y/n) }\\
95 {\tt\it y }  \\
96 {\tt Enter their names in UPPERCASE  (1/1 line) }\\
97 {\tt End by END}\\
98 {\tt\it DTHCONV }  \\
99 {\tt\it DRVCONV }  \\
100 {\tt\it END }  \\
101 \end{tabular}
102 \normalsize