MPTRAC
Functions
met_sample.c File Reference

Sample meteorological data at given geolocations. More...

#include "mptrac.h"

Go to the source code of this file.

Functions

void usage (void)
 Print command-line help. More...
 
int main (int argc, char *argv[])
 

Detailed Description

Sample meteorological data at given geolocations.

Definition in file met_sample.c.

Function Documentation

◆ usage()

void usage ( void  )

Print command-line help.

Definition at line 185 of file met_sample.c.

186 {
187
188 printf("\nMPTRAC met_sample tool.\n\n");
189 printf("Sample meteorological data at atmospheric particle locations.\n");
190 printf("\n");
191 printf("Usage:\n");
192 printf(" met_sample <ctl> <sample.tab> <atm_in> [KEY VALUE ...]\n");
193 printf("\n");
194 printf("Arguments:\n");
195 printf(" <ctl> Control file.\n");
196 printf(" <sample.tab> Output table.\n");
197 printf(" <atm_in> Atmospheric input file with sample locations.\n");
198 printf(" [KEY VALUE] Optional control parameters.\n");
199 printf("\nFurther information:\n");
200 printf(" Manual: https://slcs-jsc.github.io/mptrac/\n");
201}

◆ main()

int main ( int  argc,
char *  argv[] 
)

Definition at line 39 of file met_sample.c.

41 {
42
43 ctl_t ctl;
44
45 clim_t *clim;
46
47 atm_t *atm;
48
49 met_t *met0, *met1;
50
51 dd_t *dd;
52
53 FILE *out;
54
55 double h2o, h2ot, o3, lwc, rwc, iwc, swc, cc, p0, p1, ps, ts, zs, us, vs,
56 ess, nss, shf, lsm, sst, pbl, pt, pct, pcb, cl, plcl, plfc, pel,
57 cape, cin, o3c, pv, t, tt, u, v, w, z, zm, zref, zt, time_old = -999,
58 p_old = -999, lon_old = -999, lat_old = -999;
59
60 /* Print usage information... */
61 USAGE;
62
63 /* Check arguments... */
64 if (argc < 3)
65 ERRMSG("Missing or invalid command-line arguments.\n\n"
66 "Usage: met_sample <ctl> <sample.tab> <atm_in> [KEY VALUE ...]\n\n"
67 "Use -h for full help.");
68
69 /* Allocate... */
70 ALLOC(clim, clim_t, 1);
71 ALLOC(atm, atm_t, 1);
72 ALLOC(met0, met_t, 1);
73 ALLOC(met1, met_t, 1);
74 ALLOC(dd, dd_t, 1);
75
76 /* Read control parameters... */
77 mptrac_read_ctl(argv[1], argc, argv, &ctl);
78 const int geopot =
79 (int) scan_ctl(argv[1], argc, argv, "SAMPLE_GEOPOT", -1, "0", NULL);
80 const int grid_time =
81 (int) scan_ctl(argv[1], argc, argv, "SAMPLE_GRID_TIME", -1, "0", NULL);
82 const int grid_z =
83 (int) scan_ctl(argv[1], argc, argv, "SAMPLE_GRID_Z", -1, "0", NULL);
84 const int grid_lon =
85 (int) scan_ctl(argv[1], argc, argv, "SAMPLE_GRID_LON", -1, "0", NULL);
86 const int grid_lat =
87 (int) scan_ctl(argv[1], argc, argv, "SAMPLE_GRID_LAT", -1, "0", NULL);
88
89 /* Read climatological data... */
90 mptrac_read_clim(&ctl, clim);
91
92 /* Read atmospheric data... */
93 if (!mptrac_read_atm(argv[3], &ctl, atm))
94 ERRMSG("Cannot open file!");
95
96 /* Create output file... */
97 LOG(1, "Write meteorological data file: %s", argv[2]);
98 if (!(out = fopen(argv[2], "w")))
99 ERRMSG("Cannot create file!");
100
101 /* Write header... */
103
104 /* Loop over air parcels... */
105 for (int ip = 0; ip < atm->np; ip++) {
106
107 /* Get meteorological data... */
108 mptrac_get_met(&ctl, clim, atm->time[ip], &met0, &met1, dd);
109
110 /* Set reference pressure for interpolation... */
112 double pref = atm->p[ip];
113 if (geopot) {
114 zref = Z(pref);
115 p0 = met0->p[0];
116 p1 = met0->p[met0->np - 1];
117 for (int it = 0; it < 24; it++) {
118 pref = 0.5 * (p0 + p1);
119 intpol_met_time_3d(met0, met0->z, met1, met1->z, atm->time[ip], pref,
120 atm->lon[ip], atm->lat[ip], &zm, ci, cw, 1);
121 if (zref > zm || !isfinite(zm))
122 p0 = pref;
123 else
124 p1 = pref;
125 }
126 pref = 0.5 * (p0 + p1);
127 }
128
129 /* Interpolate meteo data... */
130 INTPOL_TIME_ALL(atm->time[ip], pref, atm->lon[ip], atm->lat[ip]);
131
132 /* Make blank lines... */
133 if (ip == 0 || (grid_time && atm->time[ip] != time_old)
134 || (grid_z && atm->p[ip] != p_old)
135 || (grid_lon && atm->lon[ip] != lon_old)
136 || (grid_lat && atm->lat[ip] != lat_old))
137 fprintf(out, "\n");
138 time_old = atm->time[ip];
139 p_old = atm->p[ip];
140 lon_old = atm->lon[ip];
141 lat_old = atm->lat[ip];
142
143 /* Write data... */
144 fprintf(out,
145 "%.2f %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g"
146 " %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g"
147 " %g %g %g %g %g %g %g %g %g %g %g %g %g %g 1 1 1\n",
148 atm->time[ip], Z(atm->p[ip]), atm->lon[ip], atm->lat[ip],
149 atm->p[ip], t, u, v, w, h2o, o3, z, pv, ps, ts, zs, us, vs,
150 ess, nss, shf, lsm,
151 sst, pt, zt, tt, h2ot, lwc, rwc, iwc, swc, cc, cl, pct, pcb, plcl,
152 plfc, pel, cape, cin, RH(atm->p[ip], t, h2o), RHICE(atm->p[ip], t,
153 h2o),
154 TDEW(atm->p[ip], h2o), TICE(atm->p[ip], h2o),
155 nat_temperature(atm->p[ip], h2o,
156 clim_zm(&clim->hno3, atm->time[ip], atm->lat[ip],
157 atm->p[ip])), clim_zm(&clim->hno3,
158 atm->time[ip],
159 atm->lat[ip],
160 atm->p[ip]),
161 clim_oh(&ctl, clim, atm->time[ip], atm->lon[ip], atm->lat[ip],
162 atm->p[ip]), clim_zm(&clim->h2o2, atm->time[ip],
163 atm->lat[ip], atm->p[ip]),
164 clim_zm(&clim->ho2, atm->time[ip], atm->lat[ip], atm->p[ip]),
165 clim_zm(&clim->o1d, atm->time[ip], atm->lat[ip], atm->p[ip]), pbl,
166 o3c);
167 }
168
169 /* Close file... */
170 fclose(out);
171
172 /* Free... */
173 free(clim);
174 free(atm);
175 free(met0);
176 free(met1);
177 free(dd);
178
179 return EXIT_SUCCESS;
180}
double clim_zm(const clim_zm_t *zm, const double t, const double lat, const double p)
Interpolates monthly mean zonal mean climatological variables.
Definition: mptrac.c:405
void intpol_met_time_3d(const met_t *met0, float array0[EX][EY][EP], const met_t *met1, float array1[EX][EY][EP], const double ts, const double p, const double lon, const double lat, double *var, int *ci, double *cw, const int init)
Interpolates meteorological data in 3D space and time.
Definition: mptrac.c:2141
double nat_temperature(const double p, const double h2o, const double hno3)
Calculates the nitric acid trihydrate (NAT) temperature.
Definition: mptrac.c:6721
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:10745
void mptrac_get_met(ctl_t *ctl, clim_t *clim, const double t, met_t **met0, met_t **met1, dd_t *dd)
Retrieves meteorological data for the specified time.
Definition: mptrac.c:4976
void mptrac_read_clim(const ctl_t *ctl, clim_t *clim)
Reads various climatological data and populates the given climatology structure.
Definition: mptrac.c:5188
int mptrac_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:5117
double clim_oh(const ctl_t *ctl, const clim_t *clim, const double t, const double lon, const double lat, const double p)
Calculates the hydroxyl radical (OH) concentration from climatology data, with an optional diurnal co...
Definition: mptrac.c:89
void mptrac_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:5248
#define INTPOL_INIT
Initialize arrays for interpolation.
Definition: mptrac.h:870
#define ERRMSG(...)
Print an error message with contextual information and terminate the program.
Definition: mptrac.h:2102
#define USAGE
Print usage information on -h or --help.
Definition: mptrac.h:1909
#define Z(p)
Convert pressure to altitude.
Definition: mptrac.h:1939
#define MET_HEADER
Write header for meteorological data file.
Definition: mptrac.h:1088
#define TICE(p, h2o)
Calculate frost point temperature (WMO, 2018).
Definition: mptrac.h:1796
#define RHICE(p, t, h2o)
Compute relative humidity over ice.
Definition: mptrac.h:1632
#define INTPOL_TIME_ALL(time, p, lon, lat)
Interpolate multiple meteorological variables in time.
Definition: mptrac.h:974
#define ALLOC(ptr, type, n)
Allocate memory for a pointer with error handling.
Definition: mptrac.h:453
#define RH(p, t, h2o)
Compute relative humidity over water.
Definition: mptrac.h:1602
#define LOG(level,...)
Print a log message with a specified logging level.
Definition: mptrac.h:2032
#define TDEW(p, h2o)
Calculate dew point temperature.
Definition: mptrac.h:1771
Air parcel data.
Definition: mptrac.h:3241
double time[NP]
Time [s].
Definition: mptrac.h:3247
double lat[NP]
Latitude [deg].
Definition: mptrac.h:3256
double lon[NP]
Longitude [deg].
Definition: mptrac.h:3253
int np
Number of air parcels.
Definition: mptrac.h:3244
double p[NP]
Pressure [hPa].
Definition: mptrac.h:3250
Climatological data.
Definition: mptrac.h:3436
clim_zm_t ho2
HO2 zonal means.
Definition: mptrac.h:3466
clim_zm_t hno3
HNO3 zonal means.
Definition: mptrac.h:3457
clim_zm_t o1d
O(1D) zonal means.
Definition: mptrac.h:3469
clim_zm_t h2o2
H2O2 zonal means.
Definition: mptrac.h:3463
Control parameters.
Definition: mptrac.h:2190
Domain decomposition data structure.
Definition: mptrac.h:3669
Meteo data structure.
Definition: mptrac.h:3495
int np
Number of pressure levels.
Definition: mptrac.h:3507
float z[EX][EY][EP]
Geopotential height [km].
Definition: mptrac.h:3606
double p[EP]
Pressure levels [hPa].
Definition: mptrac.h:3519
Here is the call graph for this function: