File: operations.html

package info (click to toggle)
harp 1.5%2Bdata-3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 54,032 kB
  • sloc: xml: 286,510; ansic: 143,710; yacc: 1,910; python: 913; makefile: 600; lex: 574; sh: 69
file content (821 lines) | stat: -rw-r--r-- 79,161 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821


<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>Operations &mdash; HARP 1.5 documentation</title>
  

  
  
  
  

  

  
  
    

  

  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="next" title="Ingestion definitions" href="ingestions/index.html" />
    <link rel="prev" title="wind velocity derivations" href="algorithms/derivations/wind_velocity.html" /> 

  
  <script src="_static/js/modernizr.min.js"></script>

</head>

<body class="wy-body-for-nav">

   
  <div class="wy-grid-for-nav">

    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search">
          

          
            <a href="index.html" class="icon icon-home"> HARP
          

          
          </a>

          
            
            
              <div class="version">
                1.5
              </div>
            
          

          

          
        </div>

        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="install.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="conventions/index.html">Conventions</a></li>
<li class="toctree-l1"><a class="reference internal" href="algorithms/index.html">Algorithms</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Operations</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#comparison-filter">Comparison filter</a></li>
<li class="toctree-l2"><a class="reference internal" href="#membership-test-filter">Membership test filter</a></li>
<li class="toctree-l2"><a class="reference internal" href="#function-call">Function call</a></li>
<li class="toctree-l2"><a class="reference internal" href="#collocation-result-file">Collocation result file</a></li>
<li class="toctree-l2"><a class="reference internal" href="#area-mask-file">Area mask file</a></li>
<li class="toctree-l2"><a class="reference internal" href="#examples">Examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="#formal-definition">Formal definition</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="ingestions/index.html">Ingestion definitions</a></li>
<li class="toctree-l1"><a class="reference internal" href="libharp.html">C library</a></li>
<li class="toctree-l1"><a class="reference internal" href="idl.html">IDL interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="matlab.html">MATLAB interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="python.html">Python interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="tools.html">Command line tools</a></li>
</ul>

            
          
        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="index.html">HARP</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          















<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="index.html">Docs</a> &raquo;</li>
        
      <li>Operations</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
            
        
      </li>
    
  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="operations">
<h1>Operations</h1>
<p>HARP provides a simple expression syntax with which one can specify operations that need to be performed on a product.
A list of operations is always provided as a single string where individual operations are separated by a semi-colon (<cite>;</cite>).
Each operation can be either a comparison filter, a membership test filter, or a function call.
Strings used in operations should be quoted with double quotes.</p>
<div class="section" id="comparison-filter">
<h2>Comparison filter</h2>
<blockquote>
<div><code class="docutils literal notranslate"><span class="pre">variable</span> <span class="pre">operator</span> <span class="pre">value</span> <span class="pre">[unit]</span></code></div></blockquote>
<p>Filter a dimension for all variables in the product such that items for which
the value of the provided variable does not match the expression get excluded.
The variable should be one dimensional or two dimensional (with the first
dimension being time). The dimension that gets filtered is the last dimension
of the referenced variable.</p>
<p>Supported operators are:</p>
<blockquote>
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">==</span></code> <code class="docutils literal notranslate"><span class="pre">!=</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">&lt;</span></code> <code class="docutils literal notranslate"><span class="pre">&lt;=</span></code> <code class="docutils literal notranslate"><span class="pre">&gt;=</span></code> <code class="docutils literal notranslate"><span class="pre">&gt;</span></code> (for numerical values only)</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">=&amp;</span></code> <code class="docutils literal notranslate"><span class="pre">!&amp;</span></code> (bitfield operators, for integer values only)</div>
</div>
</div></blockquote>
<p>Bitfield operators work such that <code class="docutils literal notranslate"><span class="pre">a</span> <span class="pre">=&amp;</span> <span class="pre">5</span></code> returns true if both bits 1 and 3 in <code class="docutils literal notranslate"><span class="pre">a</span></code> are set
and <code class="docutils literal notranslate"><span class="pre">a</span> <span class="pre">!&amp;</span> <span class="pre">5</span></code> returns true if neither bits 1 and 3 in <code class="docutils literal notranslate"><span class="pre">a</span></code> are set.</p>
<p>If a unit is specified, the comparison will be performed in the specified unit.
Otherwise, it will be performed in the unit that the variable currently has.
Units can only be specified for numerical values.</p>
</div>
<div class="section" id="membership-test-filter">
<h2>Membership test filter</h2>
<blockquote>
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">variable</span> <span class="pre">in</span> <span class="pre">(value,</span> <span class="pre">...)</span> <span class="pre">[unit]</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">variable</span> <span class="pre">not</span> <span class="pre">in</span> <span class="pre">(value,</span> <span class="pre">...)</span> <span class="pre">[unit]</span></code></div>
</div>
</div></blockquote>
<p>Exclude measurements that occur or do not occur in the specified list.</p>
<p>If a unit is specified, the comparison will be performed in the specified unit.
Otherwise, it will be performed in the unit that the variable currently has.
Units can only be specified for numerical variables.</p>
</div>
<div class="section" id="function-call">
<h2>Function call</h2>
<blockquote>
<div><code class="docutils literal notranslate"><span class="pre">function(argument,</span> <span class="pre">...)</span></code></div></blockquote>
<p>Supported functions:</p>
<blockquote>
<div><dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">area_covers_area((lat,</span> <span class="pre">...)</span> <span class="pre">[unit],</span> <span class="pre">(lon,</span> <span class="pre">...)</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">Exclude measurements whose area does not fully cover the given polygon.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">area_covers_area((51.98,51.98,52.02,52.02),(4.33,4.39,4.39,4.33))</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_covers_area(area-mask-file)</span></code></dt>
<dd><p class="first">Exclude measurements whose area does not fully cover one of the
areas of the area mask file.</p>
<p>Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">area_covers_area(&quot;areas.csv&quot;)</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_covers_point(latitude</span> <span class="pre">[unit],</span> <span class="pre">longitude</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">Exclude measurements whose area does not cover the given point.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">area_covers_point(52.012,</span> <span class="pre">4.357)</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_inside_area((lat,</span> <span class="pre">...)</span> <span class="pre">[unit],</span> <span class="pre">(lon,</span> <span class="pre">...)</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">Exclude measurements whose area is not inside the given polygon.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">area_inside_area((50,50,54,54),(3,8,8,3))</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_inside_area(area-mask-file)</span></code></dt>
<dd>Exclude measurements whose area is not inside one of the areas of
the area mask file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_intersects_area((lat,</span> <span class="pre">...)</span> <span class="pre">[unit],</span> <span class="pre">(lon,</span> <span class="pre">...)</span> <span class="pre">[unit],</span> <span class="pre">minimum-overlap-fraction)</span></code></dt>
<dd>Exclude measurements whose area does not overlap at least the
specified fraction with the given polygon.
The fraction is calculated as area(intersection)/min(area(x),area(y))</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_intersects_area(area-mask-file,</span> <span class="pre">minimum-overlap-fraction)</span></code></dt>
<dd>Exclude measurements whose area does not overlap at least the
specified fraction with one the areas of the area mask file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_intersects_area((lat,</span> <span class="pre">...)</span> <span class="pre">[unit],</span> <span class="pre">(lon,</span> <span class="pre">...)</span> <span class="pre">[unit])</span></code></dt>
<dd>Exclude measurements whose area does not overlap with the given
polygon.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">area_intersects_area(area-mask-file)</span></code></dt>
<dd>Exclude measurements whose area does not overlap with one of the
areas of the area mask file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">bin()</span></code></dt>
<dd>For all variables in a product perform an averaging in the time
dimension such that all samples end up in a single bin.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">bin(variable)</span></code></dt>
<dd><p class="first">For all variables in a product perform an averaging in the time
dimension such that all samples in the same bin get averaged.
A bin is defined by all samples of the given variable that have
the same value.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">bin(index)</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">bin(validity)</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">bin(collocation-result-file,</span> <span class="pre">a|b)</span></code></dt>
<dd><p class="first">For all variables in a product perform an averaging in the time
dimension such that all samples in the same bin get averaged.
A bin is defined by all samples having the same collocated sample
from the dataset that is indicated by the second parameter.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">bin(&quot;collocation-result.csv&quot;,</span> <span class="pre">b)</span></code></div>
<div class="line">(the product is part of dataset A and the collocated
sample that defines the bin is part of dataset B)</div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">bin_spatial((lat_edge,</span> <span class="pre">lat_edge,</span> <span class="pre">...),</span> <span class="pre">(lon_edge,</span> <span class="pre">lon_edge,</span> <span class="pre">...))</span></code></dt>
<dd><p class="first">For all variables in a product map all time samples onto a
spatial latitude/longitude grid. The latitude/longitude grid is
defined by the list of edge values.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">bin_spatial((-90,-60,-30,0,30,60,90),(-180,0,180))</span></code></div>
<div class="line">(bin data onto latitude bands, separated into an</div>
<div class="line-block">
<div class="line">eastern and western hemisphere)</div>
</div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">bin_spatial(lat_edge_length,</span> <span class="pre">lat_edge_offset,</span> <span class="pre">lat_edge_step,</span> <span class="pre">lon_edge_length,</span> <span class="pre">lon_edge_offset,</span> <span class="pre">lon_edge_step)</span></code></dt>
<dd><p class="first">For all variables in a product map all time samples onto a
spatial latitude/longitude grid. The latitude/longitude grid is
defined by the list of edge values.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">bin_spatial(7,</span> <span class="pre">-90,</span> <span class="pre">30,</span> <span class="pre">3,</span> <span class="pre">-180,</span> <span class="pre">180)</span></code></div>
<div class="line">(this is the same as <code class="docutils literal notranslate"><span class="pre">bin_spatial((-90,-60,-30,0,30,60,90),(-180,0,180))</span></code>)</div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">collocate_left(collocation-result-file)</span></code></dt>
<dd>Apply the specified collocation result file as an index
filter assuming the product is part of dataset A.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">collocate_right(collocation-result-file)</span></code></dt>
<dd>Apply the specified collocation result file as an index
filter assuming the product is part of dataset B.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">derive(variable</span> <span class="pre">[datatype]</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">The derive operation <em>without</em> a dimension specification can be
used to change the data type or unit of an already existing
variable. A variable with the given name should therefore already
be in the product (with any kind of dimensions).
If a unit conversion is performed and no data type is specified
the variable will be converted to <code class="docutils literal notranslate"><span class="pre">double</span></code> values.</p>
<p>Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">derive(altitude</span> <span class="pre">[km])</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">derive(latitude</span> <span class="pre">float)</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">derive(variable</span> <span class="pre">[datatype]</span> <span class="pre">{dimension-type,</span> <span class="pre">...}</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">The derive operation <em>with</em> a dimension specification is used
to derive the specified variable from other variables found in
the product (i.e. a variable with that name and dimension does
not have to exist yet). The <code class="docutils literal notranslate"><span class="pre">--list-derivations</span></code> option of
harpdump can be used to list available variable conversions.
The algorithms behind all the conversions are described
in the <a class="reference internal" href="algorithms/index.html"><span class="doc">Algorithms</span></a> section of the
documentation.
If the datatype is not provided then the default result data
type for a conversion will be used (usually <code class="docutils literal notranslate"><span class="pre">double</span></code>).
If a variable with the given name and dimension specification
already exists then this operation will just perform a data
type and/or unit conversion on that variable.</p>
<p>Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">derive(number_density</span> <span class="pre">{time,vertical}</span> <span class="pre">[molec/m3])</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">derive(latitude</span> <span class="pre">float</span> <span class="pre">{time})</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">derive_smoothed_column(variable</span> <span class="pre">{dimension-type,</span> <span class="pre">...}</span> <span class="pre">[unit],</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocation-result-file,</span> <span class="pre">a|b,</span> <span class="pre">dataset-dir)</span></code></dt>
<dd><p class="first">Derive the given integrated column value by first deriving
a partial column profile variant of the variable and then
smoothing/integrating this partial column profile using the
column avaraging kernel (and a-priori, if available) from a
collocated dataset. The fourth parameter indicates which dataset
contains the avaraging kernel.
Before smoothing the partial column profile is regridded to
the grid of the column averaging kernel using the given
axis-variable (see also <code class="docutils literal notranslate"><span class="pre">regrid()</span></code>).</p>
<p>Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">derive_smoothed_column(O3_column_number_density</span> <span class="pre">{time}</span> <span class="pre">[molec/cm2],</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">&quot;collocation-result.csv&quot;,</span> <span class="pre">b,</span> <span class="pre">&quot;./correlative_data/&quot;)</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">derive_smoothed_column(variable</span> <span class="pre">{dimension-type,</span> <span class="pre">...}</span> <span class="pre">[unit],</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocated-file)</span></code></dt>
<dd><p class="first">Derive the given integrated column value by first deriving
a partial column profile variant of the variable and then
smoothing/integrating this partial column profile using the
column avaraging kernel (and a-priori, if available) from a
single merged collocated product. Both the product and the
collocated product need to have a <code class="docutils literal notranslate"><span class="pre">collocation_index</span></code>
variable that will be used to associate the right collocated
grid/avk/apriori to each sample.
Before smoothing the partial column profile is regridded to
the grid of the column averaging kernel using the given
axis-variable (see also <code class="docutils literal notranslate"><span class="pre">regrid()</span></code>).</p>
<p>Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">derive_smoothed_column(O3_column_number_density</span> <span class="pre">{time}</span> <span class="pre">[molec/cm2],</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">&quot;./collocated_file.nc&quot;)</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">exclude(variable,</span> <span class="pre">...)</span></code></dt>
<dd>Mark the specified variable(s) for exclusion from the
ingested product. All variables marked for exclusion
will be excluded from the ingested product, all other
variables will be kept.
Variables that do not exist will be ignored.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">flatten(dimension)</span></code></dt>
<dd><p class="first">Flatten a product for a certain dimension by collapsing the
given dimension into the time dimension. The time dimension
will thus grow by a factor equal to the length of the given
dimension and none of the variables in the product will
depend on the given dimension anymore. If the length of the
flattened dimension does not equal 1 then: variables that
depend more than once on the given dimension will be removed,
the index and collocation_index variables will be removed,
and time independent variables are made time dependent.
Independent dimensions and the time dimension cannot be flattened.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">flatten(latitude);flatten(longitude)</span></code></div>
<div class="line">(turn a 2D lat/lon grid into a a series of individual points)</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">regrid(vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">(20));flatten(vertical)</span></code></div>
<div class="line">(vertically slice the product at 20 km altitude)</div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">keep(variable,</span> <span class="pre">...)</span></code></dt>
<dd>Mark the specified variable(s) for inclusion in the
ingested product. All variables marked for inclusion
will be kept in the ingested product, all other
variables will be excluded.
Trying to keep a variable that does not exist will
result in an error.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">longitude_range(minimum</span> <span class="pre">[unit],</span> <span class="pre">maximum</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">Exclude measurements of which the longitude of the
measurement location falls outside the specified range.
This function correctly handles longitude ranges that
cross the international date line.</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">longitude_range(179.0,</span> <span class="pre">-179.0)</span></code></div>
<div class="line">(select a 2 degree range around the international dateline)</div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">point_distance(latitude</span> <span class="pre">[unit],</span> <span class="pre">longitude</span> <span class="pre">[unit],</span> <span class="pre">distance</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">Exclude measurements whose point location is situated further than
the specified distance from the given location.
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">point_distance(52.012,</span> <span class="pre">4.357,</span> <span class="pre">3</span> <span class="pre">[km])</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">point_in_area((lat,</span> <span class="pre">...)</span> <span class="pre">[unit],</span> <span class="pre">(lon,</span> <span class="pre">...)</span> <span class="pre">[unit])</span></code></dt>
<dd><p class="first">Exclude measurements whose point location does not fall inside the
measurement area.
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">point_in_area((50,50,54,54)</span> <span class="pre">[degN],(3,8,8,3)</span> <span class="pre">[degE])</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">point_in_area(area-mask-file)</span></code></dt>
<dd>Exclude measurements whose point location does not fall inside one of
the areas from the area mask file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">regrid(dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">(value,</span> <span class="pre">...))</span></code></dt>
<dd><p class="first">Regrid all variables in the product for the given dimension using
the given axis variable as target grid. The operation will use a
<code class="docutils literal notranslate"><span class="pre">derive(axis-variable</span> <span class="pre">{[time,]dimension}</span> <span class="pre">unit)</span></code> to determine
the current grid. The target grid is specified as a list of values.
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">regrid(vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">(1.0,</span> <span class="pre">2.0,</span> <span class="pre">5.0,</span> <span class="pre">10.0,</span> <span class="pre">15.0,</span> <span class="pre">20.0,</span> <span class="pre">30.0))</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">regrid(dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">(value,</span> <span class="pre">...),</span> <span class="pre">(value,</span> <span class="pre">...))</span></code></dt>
<dd><p class="first">Regrid all variables in the product for the given dimension using
the given axis variable as target grid. The operation will use a
<code class="docutils literal notranslate"><span class="pre">derive(axis-variable</span> <span class="pre">{[time,]dimension}</span> <span class="pre">unit)</span></code> and
<code class="docutils literal notranslate"><span class="pre">derive(&lt;axis-variable&gt;_bounds</span> <span class="pre">{[time,]dimension}</span> <span class="pre">unit)</span></code> to
determine the current grid and boundaries. The target grid mid points
are specified by the first list of values and the target grid
boundaries by the second list of values. If there are N mid points,
then the list of boundary values can either contain N+1 points if the
boundaries are adjacent or 2N points to define each boundary pair
separately.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">regrid(vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">(1.0,</span> <span class="pre">2.0,</span> <span class="pre">5.0),</span> <span class="pre">(0.0,</span> <span class="pre">1.5,</span> <span class="pre">3.0,</span> <span class="pre">7.0))</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">regrid(vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">(1.0,</span> <span class="pre">2.0,</span> <span class="pre">5.0),</span> <span class="pre">(0.5,</span> <span class="pre">1.5,</span> <span class="pre">1.5,</span> <span class="pre">2.5,</span> <span class="pre">4.0,</span> <span class="pre">6.0))</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">regrid(dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">length,</span> <span class="pre">offset,</span> <span class="pre">step)</span></code></dt>
<dd><p class="first">Regrid all variables in the product for the given dimension using
the given axis variable as target grid. The operation will use a
<code class="docutils literal notranslate"><span class="pre">derive(axis-variable</span> <span class="pre">{[time,]dimension}</span> <span class="pre">unit)</span></code> to determine
the current grid. The target grid is specified as using a length,
offset, and step parameters.
Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">regrid(vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">10,</span> <span class="pre">0.5,</span> <span class="pre">1.0)</span></code></div>
<div class="line">(indicating a grid of altitudes 0.5, 1.5, …, 9.5)</div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">regrid(time,</span> <span class="pre">datetime</span> <span class="pre">[hours</span> <span class="pre">since</span> <span class="pre">2017-04-01],</span> <span class="pre">23,</span> <span class="pre">0.5,</span> <span class="pre">1.0)</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">regrid(dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocation-result-file,</span> <span class="pre">a|b,</span> <span class="pre">dataset-dir)</span></code></dt>
<dd><p class="first">Regrid all variables in the product for the given dimension using the
target grid taken from a collocated dataset. The fourth parameter
indicates which dataset contains the target grid.
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">regrid(vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">&quot;collocation-result.csv&quot;,</span> <span class="pre">b,</span> <span class="pre">&quot;./correlative_data/&quot;)</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">regrid(dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocated-file)</span></code></dt>
<dd><p class="first">Regrid all variables in the product for the given dimension using the
target grid taken from a single merged collocated product. Both the
product and the collocated product need to have a <code class="docutils literal notranslate"><span class="pre">collocation_index</span></code>
variable that will be used to associate the right collocated grid to
each sample.
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">regrid(vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">&quot;./collocated_file.nc&quot;)</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">rename(variable,</span> <span class="pre">new_name)</span></code></dt>
<dd><p class="first">Rename the variable to the new name.
Note that this operation should be used with care since it will
change the meaning of the data (potentially interpreting it
incorrectly in further operations). It is primarilly meant to
add/remove prefixes (such as surface/tropospheric/etc.) to allow
the variable to be used in a more specific (with prefix) or
generic (without prefix) way.
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">rename(surface_temperature,</span> <span class="pre">temperature)</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">set(option,</span> <span class="pre">value)</span></code></dt>
<dd><p class="first">Set a specific option in HARP.
Both the option and value parameters need to be provided as string
values (using double quotes).
Options will be set ‘globally’ in HARP and will persists for all
further operations in the list. After termination of the list of
operations, all HARP options will be reverted back to their initial
values.
Available options are:</p>
<dl class="docutils">
<dt><code class="docutils literal notranslate"><span class="pre">afgl86</span></code></dt>
<dd><p class="first">Possible values are:</p>
<ul class="last simple">
<li><code class="docutils literal notranslate"><span class="pre">disabled</span></code> (default) disable the use of AFGL86 climatology
in variable conversions</li>
<li><code class="docutils literal notranslate"><span class="pre">enabled</span></code> enable the use of AFGL86 climatology in variable
conversions (using seasonal and latitude band dependence)</li>
<li><code class="docutils literal notranslate"><span class="pre">usstd76</span></code> enable AFGL86 using US Standard profiles</li>
</ul>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">regrid_out_of_bounds</span></code></dt>
<dd><p class="first">Determine how to deal with interpolation of target grid values
that fall outside the source grid range.
Possible values are:</p>
<ul class="last simple">
<li><code class="docutils literal notranslate"><span class="pre">nan</span></code> (default) to set values outside the range to NaN</li>
<li><code class="docutils literal notranslate"><span class="pre">edge</span></code> to use the nearest edge value</li>
<li><code class="docutils literal notranslate"><span class="pre">extrapolate</span></code> to perform extrapolation</li>
</ul>
</dd>
</dl>
<p>Example:</p>
<blockquote class="last">
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">set(&quot;afgl86&quot;,</span> <span class="pre">&quot;enabled&quot;)</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">set(&quot;regrid_out_of_bounds&quot;,</span> <span class="pre">&quot;extrapolate&quot;)</span></code></div>
</div>
</div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">smooth(variable,</span> <span class="pre">dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocation-result-file,</span> <span class="pre">a|b,</span> <span class="pre">dataset-dir)</span></code></dt>
<dd><p class="first">Smooth the given variable in the product for the given dimension
using the avaraging kernel (and a-priori profile, if available)
from a collocated dataset. The fifth parameter indicates which
dataset contains the avaraging kernel. Before smoothing the
product is regridded to the grid of the averaging kernel using
the given axis-variable (see also <code class="docutils literal notranslate"><span class="pre">regrid()</span></code>).
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">smooth(O3_number_density,</span> <span class="pre">vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">&quot;collocation-result.csv&quot;,</span> <span class="pre">b,</span> <span class="pre">&quot;./correlative_data/&quot;)</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">smooth((variable,</span> <span class="pre">variable,</span> <span class="pre">...),</span> <span class="pre">dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocation-result-file,</span> <span class="pre">a|b,</span> <span class="pre">dataset-dir)</span></code></dt>
<dd>Same as above, but then providing a list of variables that need
to be smoothed. For each variable an associated averaging kernel
(and associated a-priori, if applicable) needs to be present in
the collocated dataset.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">smooth(variable,</span> <span class="pre">dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocated-file)</span></code></dt>
<dd><p class="first">Smooth the given variable in the product for the given dimension
using the avaraging kernel (and a-priori profile, if available)
from a single merged collocated product. Both the product and the
collocated product need to have a <code class="docutils literal notranslate"><span class="pre">collocation_index</span></code> variable
that will be used to associate the right collocated grid/avk/apriori
to each sample.
Before smoothing the product is regridded to the grid of the
averaging kernel using the given axis-variable (see also <code class="docutils literal notranslate"><span class="pre">regrid()</span></code>).
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">smooth(O3_number_density,</span> <span class="pre">vertical,</span> <span class="pre">altitude</span> <span class="pre">[km],</span> <span class="pre">&quot;./collocated_file.nc&quot;)</span></code></div></blockquote>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">smooth((variable,</span> <span class="pre">variable,</span> <span class="pre">...),</span> <span class="pre">dimension,</span> <span class="pre">axis-variable</span> <span class="pre">unit,</span> <span class="pre">collocated-file)</span></code></dt>
<dd>Same as above, but then providing a list of variables that need
to be smoothed. For each variable an associated averaging kernel
(and associated a-priori, if applicable) needs to be present in
the merged collocated file.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">sort(variable)</span></code></dt>
<dd>Reorder a dimension for all variables in the product such that the
variable provided as parameter ends up being sorted. The variable
should be one dimensional and the dimension that gets reordered is
this dimension of the referenced variable.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">valid(variable)</span></code></dt>
<dd>Filter a dimension for all variables in the product such that
invalid values for the variable provided as parameter get excluded
(values outside the valid range of the variable, or NaN).
This operation is executed similar to a comparison filter.</dd>
<dt><code class="docutils literal notranslate"><span class="pre">wrap(variable</span> <span class="pre">[unit],</span> <span class="pre">minimum,</span> <span class="pre">maximum)</span></code></dt>
<dd><p class="first">Wrap the values of the variable to the range given by minimum
and maximum. The result is: min + (value - min) % (max - min)
Example:</p>
<blockquote class="last">
<div><code class="docutils literal notranslate"><span class="pre">wrap(longitude</span> <span class="pre">[degree_east],</span> <span class="pre">-180,</span> <span class="pre">180)</span></code></div></blockquote>
</dd>
</dl>
</div></blockquote>
</div>
<div class="section" id="collocation-result-file">
<h2>Collocation result file</h2>
<p>The format of the collocation result file is described in the
<a class="reference internal" href="conventions/collocation_result.html"><span class="doc">conventions</span></a> section of the HARP documentation.</p>
</div>
<div class="section" id="area-mask-file">
<h2>Area mask file</h2>
<p>A comma separated (csv) file is used as input for area filters.</p>
<p>It has the following format:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">lat0</span><span class="p">,</span><span class="n">lon0</span><span class="p">,</span><span class="n">lat1</span><span class="p">,</span><span class="n">lon1</span><span class="p">,</span><span class="n">lat2</span><span class="p">,</span><span class="n">lon2</span><span class="p">,</span><span class="n">lat3</span><span class="p">,</span><span class="n">lon3</span>
<span class="mf">0.0</span><span class="p">,</span><span class="mf">60.0</span><span class="p">,</span><span class="mf">40.0</span><span class="p">,</span><span class="mf">60.0</span><span class="p">,</span><span class="mf">40.0</span><span class="p">,</span><span class="o">-</span><span class="mf">60.0</span><span class="p">,</span><span class="mf">0.0</span><span class="p">,</span><span class="o">-</span><span class="mf">60.0</span>
<span class="o">...</span>
</pre></div>
</div>
<p>It starts with a header with latitude, longitude column headers (this
header will be skipped by HARP). Then, each further line defines a polygon.
Each polygon consists of the vertices as defined on that line.</p>
</div>
<div class="section" id="examples">
<h2>Examples</h2>
<blockquote>
<div><div class="line-block">
<div class="line"><code class="docutils literal notranslate"><span class="pre">derive(altitude</span> <span class="pre">{time}</span> <span class="pre">[km]);</span> <span class="pre">pressure</span> <span class="pre">&gt;</span> <span class="pre">3.0</span> <span class="pre">[bar]</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">point_distance(-52.5</span> <span class="pre">[degree],</span> <span class="pre">1.0</span> <span class="pre">[rad],</span> <span class="pre">1e3</span> <span class="pre">[km])</span></code></div>
<div class="line"><code class="docutils literal notranslate"><span class="pre">index</span> <span class="pre">in</span> <span class="pre">(0,</span> <span class="pre">10,</span> <span class="pre">20,</span> <span class="pre">30,</span> <span class="pre">40);</span> <span class="pre">valid(pressure)</span></code></div>
</div>
</div></blockquote>
</div>
<div class="section" id="formal-definition">
<h2>Formal definition</h2>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">digit</span> <span class="o">=</span> <span class="s1">&#39;0&#39;</span><span class="o">|</span><span class="s1">&#39;1&#39;</span><span class="o">|</span><span class="s1">&#39;2&#39;</span><span class="o">|</span><span class="s1">&#39;3&#39;</span><span class="o">|</span><span class="s1">&#39;4&#39;</span><span class="o">|</span><span class="s1">&#39;5&#39;</span><span class="o">|</span><span class="s1">&#39;6&#39;</span><span class="o">|</span><span class="s1">&#39;7&#39;</span><span class="o">|</span><span class="s1">&#39;8&#39;</span><span class="o">|</span><span class="s1">&#39;9&#39;</span> <span class="p">;</span>
<span class="n">sign</span> <span class="o">=</span> <span class="s1">&#39;+&#39;</span><span class="o">|</span><span class="s1">&#39;-&#39;</span> <span class="p">;</span>

<span class="n">alpha</span> <span class="o">=</span>
   <span class="s1">&#39;a&#39;</span><span class="o">|</span><span class="s1">&#39;b&#39;</span><span class="o">|</span><span class="s1">&#39;c&#39;</span><span class="o">|</span><span class="s1">&#39;d&#39;</span><span class="o">|</span><span class="s1">&#39;e&#39;</span><span class="o">|</span><span class="s1">&#39;f&#39;</span><span class="o">|</span><span class="s1">&#39;g&#39;</span><span class="o">|</span><span class="s1">&#39;h&#39;</span><span class="o">|</span><span class="s1">&#39;i&#39;</span><span class="o">|</span><span class="s1">&#39;j&#39;</span><span class="o">|</span><span class="s1">&#39;k&#39;</span><span class="o">|</span><span class="s1">&#39;l&#39;</span><span class="o">|</span><span class="s1">&#39;m&#39;</span><span class="o">|</span>
   <span class="s1">&#39;n&#39;</span><span class="o">|</span><span class="s1">&#39;o&#39;</span><span class="o">|</span><span class="s1">&#39;p&#39;</span><span class="o">|</span><span class="s1">&#39;q&#39;</span><span class="o">|</span><span class="s1">&#39;r&#39;</span><span class="o">|</span><span class="s1">&#39;s&#39;</span><span class="o">|</span><span class="s1">&#39;t&#39;</span><span class="o">|</span><span class="s1">&#39;u&#39;</span><span class="o">|</span><span class="s1">&#39;v&#39;</span><span class="o">|</span><span class="s1">&#39;w&#39;</span><span class="o">|</span><span class="s1">&#39;x&#39;</span><span class="o">|</span><span class="s1">&#39;y&#39;</span><span class="o">|</span><span class="s1">&#39;z&#39;</span><span class="o">|</span>
   <span class="s1">&#39;A&#39;</span><span class="o">|</span><span class="s1">&#39;B&#39;</span><span class="o">|</span><span class="s1">&#39;C&#39;</span><span class="o">|</span><span class="s1">&#39;D&#39;</span><span class="o">|</span><span class="s1">&#39;E&#39;</span><span class="o">|</span><span class="s1">&#39;F&#39;</span><span class="o">|</span><span class="s1">&#39;G&#39;</span><span class="o">|</span><span class="s1">&#39;H&#39;</span><span class="o">|</span><span class="s1">&#39;I&#39;</span><span class="o">|</span><span class="s1">&#39;J&#39;</span><span class="o">|</span><span class="s1">&#39;K&#39;</span><span class="o">|</span><span class="s1">&#39;L&#39;</span><span class="o">|</span><span class="s1">&#39;M&#39;</span><span class="o">|</span>
   <span class="s1">&#39;N&#39;</span><span class="o">|</span><span class="s1">&#39;O&#39;</span><span class="o">|</span><span class="s1">&#39;P&#39;</span><span class="o">|</span><span class="s1">&#39;Q&#39;</span><span class="o">|</span><span class="s1">&#39;R&#39;</span><span class="o">|</span><span class="s1">&#39;S&#39;</span><span class="o">|</span><span class="s1">&#39;T&#39;</span><span class="o">|</span><span class="s1">&#39;U&#39;</span><span class="o">|</span><span class="s1">&#39;V&#39;</span><span class="o">|</span><span class="s1">&#39;W&#39;</span><span class="o">|</span><span class="s1">&#39;X&#39;</span><span class="o">|</span><span class="s1">&#39;Y&#39;</span><span class="o">|</span><span class="s1">&#39;Z&#39;</span> <span class="p">;</span>

<span class="n">character</span> <span class="o">=</span> <span class="n">alpha</span> <span class="o">|</span> <span class="n">digit</span> <span class="o">|</span>
   <span class="s1">&#39; &#39;</span><span class="o">|</span><span class="s1">&#39;!&#39;</span><span class="o">|</span><span class="s1">&#39;&quot;&#39;</span><span class="o">|</span><span class="s1">&#39;#&#39;</span><span class="o">|</span><span class="s1">&#39;$&#39;</span><span class="o">|</span><span class="s1">&#39;%&#39;</span><span class="o">|</span><span class="s1">&#39;&amp;&#39;</span><span class="o">|</span><span class="s2">&quot;&#39;&quot;</span><span class="o">|</span><span class="s1">&#39;(&#39;</span><span class="o">|</span><span class="s1">&#39;)&#39;</span><span class="o">|</span><span class="s1">&#39;*&#39;</span><span class="o">|</span><span class="s1">&#39;+&#39;</span><span class="o">|</span><span class="s1">&#39;,&#39;</span><span class="o">|</span>
   <span class="s1">&#39;-&#39;</span><span class="o">|</span><span class="s1">&#39;.&#39;</span><span class="o">|</span><span class="s1">&#39;/&#39;</span><span class="o">|</span><span class="s1">&#39;:&#39;</span><span class="o">|</span><span class="s1">&#39;;&#39;</span><span class="o">|</span><span class="s1">&#39;&lt;&#39;</span><span class="o">|</span><span class="s1">&#39;=&#39;</span><span class="o">|</span><span class="s1">&#39;&gt;&#39;</span><span class="o">|</span><span class="s1">&#39;?&#39;</span><span class="o">|</span><span class="s1">&#39;@&#39;</span><span class="o">|</span><span class="s1">&#39;[&#39;</span><span class="o">|</span><span class="s1">&#39;</span><span class="se">\&#39;</span><span class="s1">|&#39;</span><span class="p">]</span><span class="s1">&#39;|</span>
   <span class="s1">&#39;^&#39;</span><span class="o">|</span><span class="s1">&#39;_&#39;</span><span class="o">|</span><span class="s1">&#39;`&#39;</span><span class="o">|</span><span class="s1">&#39;{&#39;</span><span class="o">|</span><span class="s1">&#39;|&#39;</span><span class="o">|</span><span class="s1">&#39;}&#39;</span><span class="o">|</span><span class="s1">&#39;~&#39;</span> <span class="p">;</span>

<span class="n">identifier</span> <span class="o">=</span> <span class="n">alpha</span><span class="p">,</span> <span class="p">[{</span><span class="n">alpha</span> <span class="o">|</span> <span class="n">digit</span> <span class="o">|</span> <span class="s1">&#39;_&#39;</span><span class="p">}]</span> <span class="p">;</span>

<span class="n">variable</span> <span class="o">=</span> <span class="n">identifier</span> <span class="p">;</span>

<span class="n">variablelist</span> <span class="o">=</span>
   <span class="n">variable</span> <span class="o">|</span>
   <span class="n">variablelist</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span> <span class="p">;</span>

<span class="n">intvalue</span> <span class="o">=</span> <span class="p">[</span><span class="n">sign</span><span class="p">],</span> <span class="p">{</span><span class="n">digit</span><span class="p">}</span> <span class="p">;</span>

<span class="n">floatvalue</span> <span class="o">=</span>
   <span class="p">[</span><span class="n">sign</span><span class="p">],</span> <span class="p">(</span><span class="s1">&#39;N&#39;</span> <span class="o">|</span> <span class="s1">&#39;n&#39;</span><span class="p">),</span> <span class="p">(</span><span class="s1">&#39;A&#39;</span> <span class="o">|</span> <span class="s1">&#39;a&#39;</span><span class="p">),</span> <span class="p">(</span><span class="s1">&#39;N&#39;</span> <span class="o">|</span> <span class="s1">&#39;n&#39;</span><span class="p">)</span> <span class="o">|</span>
   <span class="p">[</span><span class="n">sign</span><span class="p">],</span> <span class="p">(</span><span class="s1">&#39;I&#39;</span> <span class="o">|</span> <span class="s1">&#39;i&#39;</span><span class="p">),</span> <span class="p">(</span><span class="s1">&#39;N&#39;</span> <span class="o">|</span> <span class="s1">&#39;n&#39;</span><span class="p">),</span> <span class="p">(</span><span class="s1">&#39;F&#39;</span> <span class="o">|</span> <span class="s1">&#39;f&#39;</span><span class="p">)</span> <span class="o">|</span>
   <span class="p">(</span><span class="n">intvalue</span><span class="p">,</span> <span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="p">[{</span><span class="n">digit</span><span class="p">}]</span> <span class="o">|</span> <span class="s1">&#39;.&#39;</span><span class="p">,</span> <span class="p">{</span><span class="n">digit</span><span class="p">}),</span> <span class="p">[(</span><span class="s1">&#39;D&#39;</span> <span class="o">|</span> <span class="s1">&#39;d&#39;</span> <span class="o">|</span> <span class="s1">&#39;E&#39;</span> <span class="o">|</span> <span class="s1">&#39;e&#39;</span><span class="p">),</span> <span class="n">intvalue</span><span class="p">]</span> <span class="p">;</span>

<span class="n">stringvalue</span> <span class="o">=</span> <span class="s1">&#39;&quot;&#39;</span><span class="p">,</span> <span class="p">[{</span><span class="n">character</span><span class="o">-</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\&#39;</span><span class="s1">, &#39;</span><span class="s2">&quot;&#39;) | &#39;</span><span class="se">\&#39;</span><span class="s2"> character}], &#39;&quot;</span><span class="s1">&#39; ;</span>

<span class="n">value</span> <span class="o">=</span> <span class="n">intvalue</span> <span class="o">|</span> <span class="n">floatvalue</span> <span class="o">|</span> <span class="n">stringvalue</span> <span class="p">;</span>

<span class="n">intvaluelist</span> <span class="o">=</span>
   <span class="n">intvalue</span> <span class="o">|</span>
   <span class="n">intvaluelist</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">intvalue</span><span class="p">;</span>

<span class="n">floatvaluelist</span> <span class="o">=</span>
   <span class="n">floatvalue</span> <span class="o">|</span>
   <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">;</span>

<span class="n">stringvaluelist</span> <span class="o">=</span>
   <span class="n">stringvalue</span> <span class="o">|</span>
   <span class="n">stringvaluelist</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">;</span>

<span class="n">valuelist</span> <span class="o">=</span> <span class="n">intvaluelist</span> <span class="o">|</span> <span class="n">floatvaluelist</span> <span class="o">|</span> <span class="n">stringvaluelist</span> <span class="p">;</span>

<span class="n">unit</span> <span class="o">=</span> <span class="s1">&#39;[&#39;</span><span class="p">,</span> <span class="p">[{</span><span class="n">character</span><span class="o">-</span><span class="p">(</span><span class="s1">&#39;]&#39;</span><span class="p">)}],</span> <span class="s1">&#39;]&#39;</span> <span class="p">;</span>

<span class="n">datatype</span> <span class="o">=</span> <span class="s1">&#39;int8&#39;</span> <span class="o">|</span> <span class="s1">&#39;int16&#39;</span> <span class="o">|</span> <span class="s1">&#39;int32&#39;</span> <span class="o">|</span> <span class="s1">&#39;float&#39;</span> <span class="o">|</span> <span class="s1">&#39;double&#39;</span> <span class="o">|</span> <span class="s1">&#39;string&#39;</span> <span class="p">;</span>

<span class="n">dimension</span> <span class="o">=</span> <span class="s1">&#39;time&#39;</span> <span class="o">|</span> <span class="s1">&#39;latitude&#39;</span> <span class="o">|</span> <span class="s1">&#39;longitude&#39;</span> <span class="o">|</span> <span class="s1">&#39;vertical&#39;</span> <span class="o">|</span> <span class="s1">&#39;spectral&#39;</span> <span class="o">|</span> <span class="s1">&#39;independent&#39;</span> <span class="p">;</span>

<span class="n">dimensionlist</span> <span class="o">=</span>
   <span class="n">dimension</span> <span class="o">|</span>
   <span class="n">dimensionlist</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">dimension</span> <span class="p">;</span>

<span class="n">dimensionspec</span> <span class="o">=</span> <span class="s1">&#39;{&#39;</span> <span class="n">dimensionlist</span> <span class="s1">&#39;}&#39;</span> <span class="p">;</span>

<span class="n">functioncall</span> <span class="o">=</span>
   <span class="s1">&#39;area_covers_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_covers_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_covers_point&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_inside_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_inside_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_intersects_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_intersects_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_intersects_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;area_intersects_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;bin&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">variable</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;bin&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="p">(</span> <span class="s1">&#39;a&#39;</span> <span class="o">|</span> <span class="s1">&#39;b&#39;</span> <span class="p">),</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;collocate_left&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;collocate_right&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;derive&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="p">[</span><span class="n">datatype</span><span class="p">],</span> <span class="p">[</span><span class="n">dimensionspec</span><span class="p">],</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;derive_smoothed_column&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">dimensionspec</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="p">(</span> <span class="s1">&#39;a&#39;</span> <span class="o">|</span> <span class="s1">&#39;b&#39;</span> <span class="p">),</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;derive_smoothed_column&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">dimensionspec</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;exclude&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variablelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;flatten&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;keep&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variablelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;longitude_range&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;point_distance&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;point_in_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;point_in_area&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;regrid&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;regrid&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">floatvaluelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;regrid&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">intvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;regrid&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="p">(</span> <span class="s1">&#39;a&#39;</span> <span class="o">|</span> <span class="s1">&#39;b&#39;</span> <span class="p">),</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;regrid&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;rename&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;set&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;smooth&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="p">(</span> <span class="s1">&#39;a&#39;</span> <span class="o">|</span> <span class="s1">&#39;b&#39;</span> <span class="p">),</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;smooth&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variablelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="p">(</span> <span class="s1">&#39;a&#39;</span> <span class="o">|</span> <span class="s1">&#39;b&#39;</span> <span class="p">),</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;smooth&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;smooth&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variablelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">dimension</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="n">unit</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">stringvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;sort&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;valid&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="o">|</span>
   <span class="s1">&#39;wrap&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">variable</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">floatvalue</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span> <span class="p">;</span>

<span class="n">operationexpr</span> <span class="o">=</span>
   <span class="n">variable</span><span class="p">,</span> <span class="n">operator</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">]</span> <span class="o">|</span>
   <span class="n">variable</span><span class="p">,</span> <span class="p">[</span><span class="s1">&#39;not&#39;</span><span class="p">],</span> <span class="s1">&#39;in&#39;</span><span class="p">,</span> <span class="s1">&#39;(&#39;</span><span class="p">,</span> <span class="n">valuelist</span><span class="p">,</span> <span class="s1">&#39;)&#39;</span><span class="p">,</span> <span class="p">[</span><span class="n">unit</span><span class="p">]</span> <span class="o">|</span>
   <span class="n">functioncall</span> <span class="o">|</span>
   <span class="n">operationexpr</span><span class="p">,</span> <span class="s1">&#39;;&#39;</span><span class="p">,</span> <span class="n">operationexpr</span> <span class="p">;</span>

<span class="n">operations</span> <span class="o">=</span>
   <span class="n">operationexpr</span> <span class="s1">&#39;;&#39;</span> <span class="o">|</span>
   <span class="n">operationexpr</span> <span class="p">;</span>
</pre></div>
</div>
</div>
</div>


           </div>
           
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="ingestions/index.html" class="btn btn-neutral float-right" title="Ingestion definitions" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
      
      
        <a href="algorithms/derivations/wind_velocity.html" class="btn btn-neutral" title="wind velocity derivations" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; Copyright 2015-2018 S&amp;T, The Netherlands

    </p>
  </div> 

</footer>

        </div>
      </div>

    </section>

  </div>
  


  

    
    
      <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
        <script type="text/javascript" src="_static/jquery.js"></script>
        <script type="text/javascript" src="_static/underscore.js"></script>
        <script type="text/javascript" src="_static/doctools.js"></script>
        <script async="async" type="text/javascript" src="/usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
    

  

  <script type="text/javascript" src="_static/js/theme.js"></script>

  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script> 

</body>
</html>