MPTRAC
atm_dist.c
Go to the documentation of this file.
1/*
2 This file is part of MPTRAC.
3
4 MPTRAC is free software: you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation, either version 3 of the License, or
7 (at your option) any later version.
8
9 MPTRAC is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
13
14 You should have received a copy of the GNU General Public License
15 along with MPTRAC. If not, see <http://www.gnu.org/licenses/>.
16
17 Copyright (C) 2013-2025 Forschungszentrum Juelich GmbH
18*/
19
25#include "mptrac.h"
26
27int main(
28 int argc,
29 char *argv[]) {
30
31 ctl_t ctl;
32
33 atm_t *atm1, *atm2;
34
35 FILE *out;
36
37 double *ahtd, *aqtd, *avtd, ahtdm, aqtdm[NQ], avtdm, *lat1_old, *lat2_old,
38 *lh1, *lh2, *lon1_old, *lon2_old, *lv1, *lv2, *rhtd, *rqtd, *rvtd, rhtdm,
39 rqtdm[NQ], rvtdm, t0 =
40 0, x0[3], x1[3], x2[3], z1, *z1_old, z2, *z2_old, *work;
41
42 int init = 0, np;
43
44 /* Allocate... */
45 ALLOC(atm1, atm_t, 1);
46 ALLOC(atm2, atm_t, 1);
47 ALLOC(lon1_old, double,
48 NP);
49 ALLOC(lat1_old, double,
50 NP);
51 ALLOC(z1_old, double,
52 NP);
53 ALLOC(lh1, double,
54 NP);
55 ALLOC(lv1, double,
56 NP);
57 ALLOC(lon2_old, double,
58 NP);
59 ALLOC(lat2_old, double,
60 NP);
61 ALLOC(z2_old, double,
62 NP);
63 ALLOC(lh2, double,
64 NP);
65 ALLOC(lv2, double,
66 NP);
67 ALLOC(ahtd, double,
68 NP);
69 ALLOC(avtd, double,
70 NP);
71 ALLOC(aqtd, double,
72 NP * NQ);
73 ALLOC(rhtd, double,
74 NP);
75 ALLOC(rvtd, double,
76 NP);
77 ALLOC(rqtd, double,
78 NP * NQ);
79 ALLOC(work, double,
80 NP);
81
82 /* Check arguments... */
83 if (argc < 6)
84 ERRMSG("Give parameters: <ctl> <dist.tab> <param> <atm1a> <atm1b>"
85 " [<atm2a> <atm2b> ...]");
86
87 /* Read control parameters... */
88 read_ctl(argv[1], argc, argv, &ctl);
89 const int ens =
90 (int) scan_ctl(argv[1], argc, argv, "DIST_ENS", -1, "-999", NULL);
91 const double p0 =
92 P(scan_ctl(argv[1], argc, argv, "DIST_Z0", -1, "-1000", NULL));
93 const double p1 =
94 P(scan_ctl(argv[1], argc, argv, "DIST_Z1", -1, "1000", NULL));
95 const double lat0 =
96 scan_ctl(argv[1], argc, argv, "DIST_LAT0", -1, "-1000", NULL);
97 const double lat1 =
98 scan_ctl(argv[1], argc, argv, "DIST_LAT1", -1, "1000", NULL);
99 const double lon0 =
100 scan_ctl(argv[1], argc, argv, "DIST_LON0", -1, "-1000", NULL);
101 const double lon1 =
102 scan_ctl(argv[1], argc, argv, "DIST_LON1", -1, "1000", NULL);
103 const double zscore =
104 scan_ctl(argv[1], argc, argv, "DIST_ZSCORE", -1, "-999", NULL);
105
106 /* Write info... */
107 LOG(1, "Write transport deviations: %s", argv[2]);
108
109 /* Create output file... */
110 if (!(out = fopen(argv[2], "w")))
111 ERRMSG("Cannot create file!");
112
113 /* Write header... */
114 fprintf(out,
115 "# $1 = time [s]\n"
116 "# $2 = time difference [s]\n"
117 "# $3 = absolute horizontal distance (%s) [km]\n"
118 "# $4 = relative horizontal distance (%s) [%%]\n"
119 "# $5 = absolute vertical distance (%s) [km]\n"
120 "# $6 = relative vertical distance (%s) [%%]\n",
121 argv[3], argv[3], argv[3], argv[3]);
122 for (int iq = 0; iq < ctl.nq; iq++)
123 fprintf(out,
124 "# $%d = %s absolute difference (%s) [%s]\n"
125 "# $%d = %s relative difference (%s) [%%]\n",
126 7 + 2 * iq, ctl.qnt_name[iq], argv[3], ctl.qnt_unit[iq],
127 8 + 2 * iq, ctl.qnt_name[iq], argv[3]);
128 fprintf(out, "# $%d = number of particles\n\n", 7 + 2 * ctl.nq);
129
130 /* Loop over file pairs... */
131 for (int f = 4; f < argc; f += 2) {
132
133 /* Read atmopheric data... */
134 if (!read_atm(argv[f], &ctl, atm1) || !read_atm(argv[f + 1], &ctl, atm2))
135 continue;
136
137 /* Check if structs match... */
138 if (atm1->np != atm2->np)
139 ERRMSG("Different numbers of particles!");
140
141 /* Get time from filename... */
142 const double t = time_from_filename(argv[f], ctl.atm_type < 2 ? 20 : 19);
143
144 /* Save initial time... */
145 if (!init) {
146 init = 1;
147 t0 = t;
148 }
149
150 /* Init... */
151 np = 0;
152 for (int ip = 0; ip < atm1->np; ip++) {
153 ahtd[ip] = avtd[ip] = rhtd[ip] = rvtd[ip] = 0;
154 for (int iq = 0; iq < ctl.nq; iq++)
155 aqtd[iq * NP + ip] = rqtd[iq * NP + ip] = 0;
156 }
157
158 /* Loop over air parcels... */
159 for (int ip = 0; ip < atm1->np; ip++) {
160
161 /* Check air parcel index... */
162 if (ctl.qnt_idx > 0
163 && (atm1->q[ctl.qnt_idx][ip] != atm2->q[ctl.qnt_idx][ip]))
164 ERRMSG("Air parcel index does not match!");
165
166 /* Check ensemble index... */
167 if (ctl.qnt_ens > 0
168 && (atm1->q[ctl.qnt_ens][ip] != ens
169 || atm2->q[ctl.qnt_ens][ip] != ens))
170 continue;
171
172 /* Check time... */
173 if (!isfinite(atm1->time[ip]) || !isfinite(atm2->time[ip]))
174 continue;
175
176 /* Check spatial range... */
177 if (atm1->p[ip] > p0 || atm1->p[ip] < p1
178 || atm1->lon[ip] < lon0 || atm1->lon[ip] > lon1
179 || atm1->lat[ip] < lat0 || atm1->lat[ip] > lat1)
180 continue;
181 if (atm2->p[ip] > p0 || atm2->p[ip] < p1
182 || atm2->lon[ip] < lon0 || atm2->lon[ip] > lon1
183 || atm2->lat[ip] < lat0 || atm2->lat[ip] > lat1)
184 continue;
185
186 /* Convert coordinates... */
187 geo2cart(0, atm1->lon[ip], atm1->lat[ip], x1);
188 geo2cart(0, atm2->lon[ip], atm2->lat[ip], x2);
189 z1 = Z(atm1->p[ip]);
190 z2 = Z(atm2->p[ip]);
191
192 /* Calculate absolute transport deviations... */
193 ahtd[np] = DIST(x1, x2);
194 avtd[np] = z1 - z2;
195 for (int iq = 0; iq < ctl.nq; iq++)
196 aqtd[iq * NP + np] = atm1->q[iq][ip] - atm2->q[iq][ip];
197
198 /* Calculate relative transport deviations... */
199 if (f > 4) {
200
201 /* Get trajectory lengths... */
202 geo2cart(0, lon1_old[ip], lat1_old[ip], x0);
203 lh1[ip] += DIST(x0, x1);
204 lv1[ip] += fabs(z1_old[ip] - z1);
205
206 geo2cart(0, lon2_old[ip], lat2_old[ip], x0);
207 lh2[ip] += DIST(x0, x2);
208 lv2[ip] += fabs(z2_old[ip] - z2);
209
210 /* Get relative transport deviations... */
211 if (lh1[ip] + lh2[ip] > 0)
212 rhtd[np] = 200. * DIST(x1, x2) / (lh1[ip] + lh2[ip]);
213 if (lv1[ip] + lv2[ip] > 0)
214 rvtd[np] = 200. * (z1 - z2) / (lv1[ip] + lv2[ip]);
215 }
216
217 /* Get relative transport deviations... */
218 for (int iq = 0; iq < ctl.nq; iq++)
219 rqtd[iq * NP + np] = 200. * (atm1->q[iq][ip] - atm2->q[iq][ip])
220 / (fabs(atm1->q[iq][ip]) + fabs(atm2->q[iq][ip]));
221
222 /* Save positions of air parcels... */
223 lon1_old[ip] = atm1->lon[ip];
224 lat1_old[ip] = atm1->lat[ip];
225 z1_old[ip] = z1;
226
227 lon2_old[ip] = atm2->lon[ip];
228 lat2_old[ip] = atm2->lat[ip];
229 z2_old[ip] = z2;
230
231 /* Increment air parcel counter... */
232 np++;
233 }
234
235 /* Filter data... */
236 if (zscore > 0 && np > 1) {
237
238 /* Get means and standard deviations of transport deviations... */
239 const size_t n = (size_t) np;
240 const double muh = gsl_stats_mean(ahtd, 1, n);
241 const double muv = gsl_stats_mean(avtd, 1, n);
242 const double sigh = gsl_stats_sd(ahtd, 1, n);
243 const double sigv = gsl_stats_sd(avtd, 1, n);
244
245 /* Filter data... */
246 np = 0;
247 for (size_t i = 0; i < n; i++)
248 if (fabs((ahtd[i] - muh) / sigh) < zscore
249 && fabs((avtd[i] - muv) / sigv) < zscore) {
250 ahtd[np] = ahtd[i];
251 rhtd[np] = rhtd[i];
252 avtd[np] = avtd[i];
253 rvtd[np] = rvtd[i];
254 for (int iq = 0; iq < ctl.nq; iq++) {
255 aqtd[iq * NP + np] = aqtd[iq * NP + (int) i];
256 rqtd[iq * NP + np] = rqtd[iq * NP + (int) i];
257 }
258 np++;
259 }
260 }
261
262 /* Get statistics... */
263 if (strcasecmp(argv[3], "mean") == 0) {
264 ahtdm = gsl_stats_mean(ahtd, 1, (size_t) np);
265 rhtdm = gsl_stats_mean(rhtd, 1, (size_t) np);
266 avtdm = gsl_stats_mean(avtd, 1, (size_t) np);
267 rvtdm = gsl_stats_mean(rvtd, 1, (size_t) np);
268 for (int iq = 0; iq < ctl.nq; iq++) {
269 aqtdm[iq] = gsl_stats_mean(&aqtd[iq * NP], 1, (size_t) np);
270 rqtdm[iq] = gsl_stats_mean(&rqtd[iq * NP], 1, (size_t) np);
271 }
272 } else if (strcasecmp(argv[3], "stddev") == 0) {
273 ahtdm = gsl_stats_sd(ahtd, 1, (size_t) np);
274 rhtdm = gsl_stats_sd(rhtd, 1, (size_t) np);
275 avtdm = gsl_stats_sd(avtd, 1, (size_t) np);
276 rvtdm = gsl_stats_sd(rvtd, 1, (size_t) np);
277 for (int iq = 0; iq < ctl.nq; iq++) {
278 aqtdm[iq] = gsl_stats_sd(&aqtd[iq * NP], 1, (size_t) np);
279 rqtdm[iq] = gsl_stats_sd(&rqtd[iq * NP], 1, (size_t) np);
280 }
281 } else if (strcasecmp(argv[3], "min") == 0) {
282 ahtdm = gsl_stats_min(ahtd, 1, (size_t) np);
283 rhtdm = gsl_stats_min(rhtd, 1, (size_t) np);
284 avtdm = gsl_stats_min(avtd, 1, (size_t) np);
285 rvtdm = gsl_stats_min(rvtd, 1, (size_t) np);
286 for (int iq = 0; iq < ctl.nq; iq++) {
287 aqtdm[iq] = gsl_stats_min(&aqtd[iq * NP], 1, (size_t) np);
288 rqtdm[iq] = gsl_stats_min(&rqtd[iq * NP], 1, (size_t) np);
289 }
290 } else if (strcasecmp(argv[3], "max") == 0) {
291 ahtdm = gsl_stats_max(ahtd, 1, (size_t) np);
292 rhtdm = gsl_stats_max(rhtd, 1, (size_t) np);
293 avtdm = gsl_stats_max(avtd, 1, (size_t) np);
294 rvtdm = gsl_stats_max(rvtd, 1, (size_t) np);
295 for (int iq = 0; iq < ctl.nq; iq++) {
296 aqtdm[iq] = gsl_stats_max(&aqtd[iq * NP], 1, (size_t) np);
297 rqtdm[iq] = gsl_stats_max(&rqtd[iq * NP], 1, (size_t) np);
298 }
299 } else if (strcasecmp(argv[3], "skew") == 0) {
300 ahtdm = gsl_stats_skew(ahtd, 1, (size_t) np);
301 rhtdm = gsl_stats_skew(rhtd, 1, (size_t) np);
302 avtdm = gsl_stats_skew(avtd, 1, (size_t) np);
303 rvtdm = gsl_stats_skew(rvtd, 1, (size_t) np);
304 for (int iq = 0; iq < ctl.nq; iq++) {
305 aqtdm[iq] = gsl_stats_skew(&aqtd[iq * NP], 1, (size_t) np);
306 rqtdm[iq] = gsl_stats_skew(&rqtd[iq * NP], 1, (size_t) np);
307 }
308 } else if (strcasecmp(argv[3], "kurt") == 0) {
309 ahtdm = gsl_stats_kurtosis(ahtd, 1, (size_t) np);
310 rhtdm = gsl_stats_kurtosis(rhtd, 1, (size_t) np);
311 avtdm = gsl_stats_kurtosis(avtd, 1, (size_t) np);
312 rvtdm = gsl_stats_kurtosis(rvtd, 1, (size_t) np);
313 for (int iq = 0; iq < ctl.nq; iq++) {
314 aqtdm[iq] = gsl_stats_kurtosis(&aqtd[iq * NP], 1, (size_t) np);
315 rqtdm[iq] = gsl_stats_kurtosis(&rqtd[iq * NP], 1, (size_t) np);
316 }
317 } else if (strcasecmp(argv[3], "absdev") == 0) {
318 ahtdm = gsl_stats_absdev_m(ahtd, 1, (size_t) np, 0.0);
319 rhtdm = gsl_stats_absdev_m(rhtd, 1, (size_t) np, 0.0);
320 avtdm = gsl_stats_absdev_m(avtd, 1, (size_t) np, 0.0);
321 rvtdm = gsl_stats_absdev_m(rvtd, 1, (size_t) np, 0.0);
322 for (int iq = 0; iq < ctl.nq; iq++) {
323 aqtdm[iq] = gsl_stats_absdev_m(&aqtd[iq * NP], 1, (size_t) np, 0.0);
324 rqtdm[iq] = gsl_stats_absdev_m(&rqtd[iq * NP], 1, (size_t) np, 0.0);
325 }
326 } else if (strcasecmp(argv[3], "median") == 0) {
327 ahtdm = gsl_stats_median(ahtd, 1, (size_t) np);
328 rhtdm = gsl_stats_median(rhtd, 1, (size_t) np);
329 avtdm = gsl_stats_median(avtd, 1, (size_t) np);
330 rvtdm = gsl_stats_median(rvtd, 1, (size_t) np);
331 for (int iq = 0; iq < ctl.nq; iq++) {
332 aqtdm[iq] = gsl_stats_median(&aqtd[iq * NP], 1, (size_t) np);
333 rqtdm[iq] = gsl_stats_median(&rqtd[iq * NP], 1, (size_t) np);
334 }
335 } else if (strcasecmp(argv[3], "mad") == 0) {
336 ahtdm = gsl_stats_mad0(ahtd, 1, (size_t) np, work);
337 rhtdm = gsl_stats_mad0(rhtd, 1, (size_t) np, work);
338 avtdm = gsl_stats_mad0(avtd, 1, (size_t) np, work);
339 rvtdm = gsl_stats_mad0(rvtd, 1, (size_t) np, work);
340 for (int iq = 0; iq < ctl.nq; iq++) {
341 aqtdm[iq] = gsl_stats_mad0(&aqtd[iq * NP], 1, (size_t) np, work);
342 rqtdm[iq] = gsl_stats_mad0(&rqtd[iq * NP], 1, (size_t) np, work);
343 }
344 } else
345 ERRMSG("Unknown parameter!");
346
347 /* Write output... */
348 fprintf(out, "%.2f %.2f %g %g %g %g", t, t - t0,
349 ahtdm, rhtdm, avtdm, rvtdm);
350 for (int iq = 0; iq < ctl.nq; iq++) {
351 fprintf(out, " ");
352 fprintf(out, ctl.qnt_format[iq], aqtdm[iq]);
353 fprintf(out, " ");
354 fprintf(out, ctl.qnt_format[iq], rqtdm[iq]);
355 }
356 fprintf(out, " %d\n", np);
357 }
358
359 /* Close file... */
360 fclose(out);
361
362 /* Free... */
363 free(atm1);
364 free(atm2);
365 free(lon1_old);
366 free(lat1_old);
367 free(z1_old);
368 free(lh1);
369 free(lv1);
370 free(lon2_old);
371 free(lat2_old);
372 free(z2_old);
373 free(lh2);
374 free(lv2);
375 free(ahtd);
376 free(avtd);
377 free(aqtd);
378 free(rhtd);
379 free(rvtd);
380 free(rqtd);
381 free(work);
382
383 return EXIT_SUCCESS;
384}
main
int main(int argc, char *argv[])
Definition: atm_dist.c:27
scan_ctl
double scan_ctl(const char *filename, int argc, char *argv[], const char *varname, const int arridx, const char *defvalue, char *value)
Scans a control file or command-line arguments for a specified variable.
Definition: mptrac.c:8503
time_from_filename
double time_from_filename(const char *filename, const int offset)
Extracts and converts a timestamp from a filename to Julian seconds.
Definition: mptrac.c:8816
read_ctl
void read_ctl(const char *filename, int argc, char *argv[], ctl_t *ctl)
Reads control parameters from a configuration file and populates the given structure.
Definition: mptrac.c:5156
read_atm
int read_atm(const char *filename, const ctl_t *ctl, atm_t *atm)
Reads air parcel data from a specified file into the given atmospheric structure.
Definition: mptrac.c:4566
geo2cart
void geo2cart(const double z, const double lon, const double lat, double *x)
Converts geographic coordinates (longitude, latitude, altitude) to Cartesian coordinates.
Definition: mptrac.c:985
mptrac.h
MPTRAC library declarations.
ERRMSG
#define ERRMSG(...)
Print an error message with contextual information and terminate the program.
Definition: mptrac.h:1916
Z
#define Z(p)
Convert pressure to altitude.
Definition: mptrac.h:1741
P
#define P(z)
Compute pressure at given altitude.
Definition: mptrac.h:1304
NQ
#define NQ
Maximum number of quantities per data point.
Definition: mptrac.h:251
ALLOC
#define ALLOC(ptr, type, n)
Allocate memory for a pointer with error handling.
Definition: mptrac.h:349
NP
#define NP
Maximum number of atmospheric data points.
Definition: mptrac.h:246
LOG
#define LOG(level,...)
Print a log message with a specified logging level.
Definition: mptrac.h:1846
DIST
#define DIST(a, b)
Calculate the distance between two points in Cartesian coordinates.
Definition: mptrac.h:578
atm_t
Air parcel data.
Definition: mptrac.h:3147
atm_t::time
double time[NP]
Time [s].
Definition: mptrac.h:3153
atm_t::lat
double lat[NP]
Latitude [deg].
Definition: mptrac.h:3162
atm_t::lon
double lon[NP]
Longitude [deg].
Definition: mptrac.h:3159
atm_t::np
int np
Number of air parcels.
Definition: mptrac.h:3150
atm_t::q
double q[NQ][NP]
Quantity data (for various, user-defined attributes).
Definition: mptrac.h:3165
atm_t::p
double p[NP]
Pressure [hPa].
Definition: mptrac.h:3156
ctl_t
Control parameters.
Definition: mptrac.h:2170
ctl_t::qnt_format
char qnt_format[NQ][LEN]
Quantity output format.
Definition: mptrac.h:2189
ctl_t::atm_type
int atm_type
Type of atmospheric data files (0=ASCII, 1=binary, 2=netCDF, 3=CLaMS_traj, 4=CLaMS_pos).
Definition: mptrac.h:2932
ctl_t::qnt_unit
char qnt_unit[NQ][LEN]
Quantity units.
Definition: mptrac.h:2186
ctl_t::qnt_name
char qnt_name[NQ][LEN]
Quantity names.
Definition: mptrac.h:2180
ctl_t::qnt_ens
int qnt_ens
Quantity array index for ensemble IDs.
Definition: mptrac.h:2195
ctl_t::qnt_idx
int qnt_idx
Quantity array index for air parcel IDs.
Definition: mptrac.h:2192
ctl_t::nq
int nq
Number of quantities.
Definition: mptrac.h:2177
Generated on Wed Jan 22 2025 18:02:19 for MPTRAC by doxygen 1.9.4