smeteo.5 (4554B)
1 .\" Copyright (C) 2025 |Méso|Star> (contact@meso-star.com) 2 .\" 3 .\" This program is free software: you can redistribute it and/or modify 4 .\" it under the terms of the GNU General Public License as published by 5 .\" the Free Software Foundation, either version 3 of the License, or 6 .\" (at your option) any later version. 7 .\" 8 .\" This program is distributed in the hope that it will be useful, 9 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of 10 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 11 .\" GNU Lesser General Public License for more details. 12 .\" 13 .\" You should have received a copy of the GNU Lesser General Public License 14 .\" along with this program. If not, see <http://www.gnu.org/licenses/>. 15 .Dd November 5, 2025 16 .Dt SMETEO 5 17 .Os 18 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 19 .Sh NAME 20 .Nm smeteo 21 .Nd file format for time varying meteorological data 22 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 23 .Sh DESCRIPTION 24 A 25 .Nm 26 file stores meteorological data in plain text. 27 The data is provided for a continuous period, discretized into fixed 28 time intervals. 29 The albedo of the ground, the geographical position (longitude, 30 latitude), and the number of intervals are indicated at the beginning of 31 the file. 32 .Pp 33 After the header, the following lines contain a set of meteorological 34 data averaged over a time interval. 35 For the same file, the duration of the intervals is constant. 36 The date indicated for each interval corresponds to the middle of the 37 time interval. 38 Date are given in Coordinated Universal Time, i.e. UTC +00:00. 39 The lines must be sorted in ascending chronological order. 40 .Pp 41 Empty lines are ignored, as are comments, which are strings beginning 42 with the sharp character 43 .Pq Li # . 44 .Pp 45 The grammar of the file format is presented below in a Backus-Naur form. 46 A description ending in a backslash 47 .Pq Li \e 48 means that the line does not end, but the rest of its content is given on the 49 next grammatical line for the convenience of formatting this manual. 50 Text introduced by the sharp character 51 .Pq Li # 52 in descriptions is a comment and does not form part of the description. 53 They are used to provide additional information. 54 .Pp 55 The file format is as follows: 56 .Bl -column (SWdn_diffuse) (::=) () 57 .It Ao Va smeteo Ac Ta ::= Ta Ao Va header Ac 58 .It Ta Ta Ao Va data-set Ac 59 .It Ta Ta ... 60 .It Ta Ta 61 .It Ao Va header Ac Ta ::= Ta Ao Va albedo Ac 62 .It Ta Ta Ao Va longitude Ac 63 .It Ta Ta Ao Va latitude Ac 64 .It Ta Ta Ao Va #intervals Ac 65 .It Ta Ta 66 .It Ao Va albedo Ac Ta ::= Ta Va real No # in [0, 1] 67 .It Ao Va longitude Ac Ta ::= Ta Va real 68 # In [\&-180, 180] deg. + towards the east 69 .It Ao Va latitude Ac Ta ::= Ta Va real 70 # In [\&-90, 90] deg. + towards the north 71 .It Ao Va #intervals Ac Ta ::= Ta Va integer 72 .It Ta Ta 73 .It Ao Va data-set Ac Ta ::= Ta 74 .Aq Va date 75 .Aq Va Tsrf 76 .Aq Va Tatm 77 .Aq Va Ahum 78 .Aq Va Rhum 79 \e 80 .It Ta Ta 81 .Aq Va SWdn 82 .Aq Va SWdn_direct 83 .Aq Va SWdn_diffuse 84 .Aq Va SWup 85 \e 86 .It Ta Ta 87 .Aq Va Trad 88 .Aq Va h 89 .Aq Va LE 90 .Aq Va day/1850 91 .It \ Ta Ta 92 .It Ao Va date Ac Ta ::= Ta 93 .Ao Va day Ac Ns - Ns 94 .Ao Va month Ac Ns - Ns 95 .Ao Va year Ac 96 .Ao Va hour Ac : Ns 97 .Ao Va minute Ac : Ns 98 .Ao Va second Ac 99 .It Ao Va day Ac Ta ::= Ta Va integer No # Bo 01, Ns 31 Bc 100 .It Ao Va month Ac Ta ::= Ta 101 \& \& 102 .Li Jan | 103 .Li Feb | 104 .Li Mar | 105 .Li Apr | 106 .Li May | 107 .Li Jun 108 .It Ta Ta 109 | 110 .Li Jul | 111 .Li Aug | 112 .Li Sep | 113 .Li Oct | 114 .Li Nov | 115 .Li Dec 116 .It Ao Va year Ac Ta ::= Ta Va integer 117 .It Ao Va hour Ac Ta ::= Ta Va integer No # Bo 0, Ns 23 Bc 118 .It Ao Va minute Ac Ta ::= Ta Va integer No # Bo 00, Ns 59 Bc 119 .It Ao Va second Ac Ta ::= Ta Va integer No # Bo 00, Ns 59 Bc 120 .It \ Ta Ta 121 .It Ao Va Tsrf Ac Ta ::= Ta Va real No # Surface temperature >0 [K] 122 .It Ao Va Tatm Ac Ta ::= Ta Va real No # Atmosphere temperature >0 [K] 123 .It Ao Va Ahum Ac Ta ::= Ta Va real No # Air humidity [g(water)/kg(air)] 124 .It Ao Va Rhum Ac Ta ::= Ta Va real No # Relative humidity in [0..100] 125 .It Ao Va SWdn Ac Ta ::= Ta Va real No # ShortWave downward flux [W.m^2] 126 .It Ao Va SWdn_direct Ac Ta ::= Ta Va real 127 # Direct ShortWave downward flux [W.m^2] 128 .It Ao Va SWdn_diffuse Ac Ta ::= Ta Va real 129 # Diffuse ShortWave downward flux [W.m^2] 130 .It Ao Va SWup Ac Ta ::= Ta Va real No # ShortWave upward flux [W.m^2] 131 .It Ao Va Trad Ac Ta ::= Ta Va real No # Radiative temperature >0 [K] 132 .It Ao Va h Ac Ta ::= Ta Va real No # Convective coefficent >0 [W/K/m^2] 133 .It Ao Va LE Ac Ta ::= Ta Va real No # Latent flux [W/m^2] 134 .It Ao Va day/1850 Ac Ta ::= Ta Va real 135 # Time in fraction of day since 1 Jan 1850 136 .El