-
Notifications
You must be signed in to change notification settings - Fork 16
/
iea43_wra_data_model.schema.json
1967 lines (1966 loc) · 89.4 KB
/
iea43_wra_data_model.schema.json
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
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$version": "1.3.0-2024.03",
"$id": "https://raw.githubusercontent.com/IEA-Task-43/digital_wra_data_standard/master/schema/iea43_wra_data_model.schema.json",
"definitions": {
"date_from": {
"type": "string",
"format": "date-time",
"title": "Date From",
"description": "The date from when these properties are active. If these properties follow a change, then this Date From should equal the previous Date To. The format of this date should follow ISO 8601 with the 'T' required. If a timezone is used, it is essential that this timezone is the same as the logger timezone.",
"examples": [
"2020-07-28T20:00:00"
]
},
"date_to": {
"type": [
"string",
"null"
],
"format": "date-time",
"title": "Date To",
"description": "The final end date for when these properties are active. If these properties are currently active please use null. If null is not allowed please use 2100-01-01T00:00:00. The format of this date should follow ISO 8601 with the 'T' required. If a timezone is used, it is essential that this timezone is the same as the logger timezone.",
"examples": [
"2020-07-28T20:00:00",
"2100-01-01T00:00:00"
]
},
"notes": {
"type": [
"string",
"null"
],
"title": "Notes",
"description": "Notes relating to these properties.",
"examples": [
"I can write anything I want here."
]
},
"update_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"title": "Date of Update",
"description": "The date these properties were last updated.",
"examples": [
"2020-07-28T20:49:13"
]
},
"offset_from_utc_hrs": {
"type": [
"number",
"null"
],
"title": "Offset From UTC [hr]",
"description": "The number of hours that the resulting timeseries dataset is offset from UTC. E.g. -5 for Eastern Standard Time.",
"examples": [
"-5 (for Eastern Standard Time)",
"1 (for Central European Time)",
"5.5 (for India Standard Time)"
]
},
"averaging_period_minutes": {
"type": [
"integer",
"null"
],
"title": "Averaging Period [min]",
"description": "The number of minutes the model outputs the timeseries data at. Also known as 'time step' or 'averaging step'",
"examples": [
"10",
"60"
]
},
"timestamp_is_end_of_period": {
"type": [
"boolean",
"null"
],
"title": "Timestamp at End of Period",
"description": "Does the timestamp represent the end of the averaging period. True is for timestamp to represent the end of the averaging period and false is for timestamp to represent the start of the averaging period.",
"examples": [
"true (for timestamp to represent the end of the averaging period)",
"false (for timestamp to represent the start of the averaging period)"
]
},
"measurement_type": {
"type": "string",
"title": "Measurement Type",
"description": "The type of measurement been made. See more information in the examples.",
"enum": [
"wind_speed",
"wind_direction",
"air_temperature",
"water_temperature",
"temperature",
"air_pressure",
"air_density",
"relative_humidity",
"voltage",
"current",
"resistance",
"power",
"energy",
"vertical_wind_speed",
"wind_speed_turbulence",
"precipitation",
"ice_detection",
"global_horizontal_irradiance",
"direct_normal_irradiance",
"diffuse_horizontal_irradiance",
"global_tilted_irradiance",
"global_normal_irradiance",
"albedo",
"soiling_loss_index",
"illuminance",
"fog",
"salinity",
"conductivity",
"pressure",
"gps_coordinates",
"status",
"flag",
"counter",
"availability",
"quality",
"carrier_to_noise_ratio",
"doppler_spectral_broadening",
"echo_intensity",
"signal_to_noise_ratio",
"motion_corrected_wind_speed",
"motion_corrected_wind_direction",
"motion_corrected_vertical_wind_speed",
"wave_height",
"wave_significant_height",
"wave_maximum_height",
"wave_direction",
"wave_directional_spread",
"wave_period",
"wave_peak_period",
"water_speed",
"vertical_water_speed",
"water_direction",
"orientation",
"compass_direction",
"true_north_offset",
"tilt",
"tilt_x",
"tilt_y",
"tilt_z",
"u",
"v",
"w",
"elevation",
"altitude",
"height",
"azimuth",
"water_level",
"depth",
"timestamp",
"obukhov_length",
"other"
],
"examples": [
"wind_speed (the horizontal component of wind speed)",
"wind_direction (the direction from which the wind is coming from)",
"air_temperature (outdoor ambient temperature of the air)",
"water_temperature (is the in situ temperature of the water. In CF Conventions this is equivalent to 'sea_water_temperature'.)",
"temperature (the temperature of a body or indoor ambient air temperature)",
"air_pressure (outdoor pressure of the air)",
"air_density (the density of air)",
"relative_humidity (outdoor relative humidity of the air",
"voltage (electrical voltage, typically the logger battery voltage)",
"current (electrical current, typically the logger battery current)",
"resistance (electrical resistance, the raw or basic measurement from many different sensors)",
"power (the amount of energy transferred or converted per unit of time)",
"energy (in physics, is the capacity for doing work. It may exist in potential, kinetic, thermal, electrical, chemical, nuclear, or other various forms.)",
"vertical_wind_speed (the vertical component of wind speed)",
"wind_speed_turbulence (the turbulence of the wind speed)",
"precipitation (water which falls to the ground from the atmosphere in forms of rain, snow, sleet, ice pellets, dew, frost, and hail)",
"ice_detection (detection of ice build up on surfaces)",
"global_horizontal_irradiance (the total power or instantaneous rate of energy from the sun received by a horizontal surface on Earth)",
"direct_normal_irradiance (the direct line of sight power or instantaneous rate of energy from the sun, excluding diffuse irradiance, received by a surface on Earth perpendicular to the sun)",
"diffuse_horizontal_irradiance (the power or instantaneous rate of energy from light scattered by the atmosphere, excluding direct irradiance, received by a horizontal surface on Earth)",
"global_tilted_irradiance (the total power or instantaneous rate of energy from the sun received by a surface on Earth with defined tilt and azimuth, fixed or sun-tracking)",
"global_normal_irradiance (the total power or instantaneous rate of energy from the sun received by a surface on Earth perpendicular to the sun)",
"albedo (or reflected solar radiation from the earth's surface, is defined as the ratio between the reflected energy and the incident energy over a unit area)",
"soiling_loss_index (an index of lost energy between clean and dirty PV modules, https://www.campbellsci.com/cr-pvs1 )",
"illuminance (measure of visible light falling onto a per unit area, typically measured in lux)",
"fog (is a visible aerosol consisting of tiny water droplets or ice crystals suspended in the air at or near the Earth's surface)",
"salinity (is the salt content of water. In CF Conventions this is equivalent to 'sea_water_salinity', 'sea_water_practical_salinity' or 'sea_water_absolute_salinity' depending on the scale been used.)",
"conductivity (of an electrolyte solution, e.g. sea water, is a measure of its ability to conduct electricity. In CF Conventions this is equivalent to 'sea_water_electrical_conductivity' for offshore use cases.)",
"pressure (the pressure of a medium e.g. water. In CF Conventions this is equivalent to 'sea_water_pressure' for offshore use cases.)",
"gps_coordinates (latitude and/or longitude as measured by a gps)",
"status (a status flag or other to describe the status of a sensor or object)",
"counter (a simple counter)",
"availability (the availability of a sensor or the presence of something in a measurement typically measured as %, e.g. '40m Data Availability (%)' or 'Proportion Of Packets with Fog (%)'. This is currently a generic catch-all for all 'availability' like metrics and may be resolved into more specific definitions in future revisions.)",
"quality (a measure of the quality of a measurement)",
"carrier_to_noise_ratio (a measure of signal strength as measured by lidar devices, http://data.windenergy.dtu.dk/ontologies/view/IEATask32Glossary/en/page/parameters.carrier_to_noise_ratio )",
"doppler_spectral_broadening (as measured by lidar devices)",
"echo_intensity (is the brightness or brilliance of the acoustic echo usually measured by an ADCP. If from an ADCP, it can be used to judge the quality of measurement or estimate the amount of suspended sediment in the water column.)",
"signal_to_noise_ratio (a measure of signal strength as measured by ADCPs.)",
"motion_corrected_wind_speed (the horizontal component of wind speed which has been corrected due to the motion of the measuring sensor/device, typically from floating lidar systems)",
"motion_corrected_wind_direction (the direction form which the wind is coming from which has been corrected due to the motion of the measuring sensor/device, typically from floating lidar systems)",
"motion_corrected_vertical_wind_speed (the vertical component of wind speed which has been corrected due to the motion of the measuring sensor/device, typically from floating lidar systems)",
"wave_height (is the mean wave height measured during the observation period, where the height is defined as the vertical distance from a wave trough to the following wave crest. In CF Conventions this is equivalent to 'sea_surface_wave_mean_height'.)",
"wave_significant_height (is a statistic computed from wave measurements and corresponds to the average height of the highest one third of the waves, where the height is defined as the vertical distance from a wave trough to the following wave crest. In CF Conventions this is equivalent to 'sea_surface_wave_significant_height'.)",
"wave_maximum_height (is the greatest trough to crest distance measured during the observation period. Wave height is defined as the vertical distance from a wave trough to the following wave crest. In CF Conventions this is equivalent to 'sea_surface_wave_maximum_height'.)",
"wave_direction (the direction from which the wave is coming from. The direction is a bearing in the usual geographical sense, measured positive clockwise from due north. In CF Conventions this is equivalent to 'sea_surface_wave_from_direction'.)",
"wave_directional_spread (is the standard deviation of all the wave directions measured. It signifies how spread out,or how wide an area, all the waves are coming from. In CF Conventions this is equivalent to 'sea_surface_wave_directional_spread'.)",
"wave_period (is the mean wave period measured during the observation period at a specific location. In CF Conventions this is equivalent to 'sea_surface_wave_mean_period'.)",
"wave_peak_period (is the wave period of the most energetic waves in the total wave spectrum at a specific location. In CF Conventions this is equivalent to 'sea_surface_wave_period_at_variance_spectral_density_maximum'.)",
"water_speed (the horizontal magnitude of the water's velocity. This is sometimes also known as 'current speed' and in CF Conventions this is equivalent to 'sea_water_speed'.)",
"vertical_water_speed (the vertical magnitude of the water's velocity. In CF Conventions this is equivalent to 'upward_sea_water_velocity'.)",
"water_direction (the direction from which the water flow is coming from. The direction is a bearing in the usual geographical sense, measured positive clockwise from due north. This is sometimes also known as 'current direction' and in CF Conventions this is equivalent to 'sea_water_velocity_from_direction' or 'sea_water_from_direction'.)",
"orientation (the direction something points or faces relative to north or other specified positions)",
"compass_direction (the direction as measured by a compass, therefore referenced to magnetic north)",
"true_north_offset (the offset something points or faces relative to true north, e.g. from a solar compass such as a Geovane)",
"tilt_x (the tilt of an object relative to the x-axis)",
"tilt_y (the tilt of an object relative to the y-axis)",
"tilt_z (the tilt of an object relative to the z-axis)",
"u (the U component vector, relating to wind it is positive for a west to east flow (eastward wind), however, it can be used for other vectors. If so, please use the notes property to define it.)",
"v (the V component vector, relating to wind it is positive for a south to north flow (northward wind), however, it can be used for other vectors. If so, please use the notes property to define it.)",
"w (the W component vector, if using this for wind please use the 'vertical_wind_speed' measurement type. Please use the notes property to define how this component is utilised.",
"elevation (the height the surface of the earth is above mean sea level)",
"altitude (the height above mean sea level or is the angle between the sun and the observer's local horizon, also sometimes referred to as elevation)",
"height (the vertical distance above a particular reference e.g. ground level.)",
"azimuth (is the angle of the sun around the horizon, in the northern hemisphere this is usually measured from north and increasing eastward whereas in the southern hemisphere it can be measured from the south and increasing westward)",
"water_level (is the height of the sea surface above the sea floor. In CF Conventions this is equivalent, but opposite in respect of their point of reference, to 'sea_floor_depth_below_sea_surface'.)",
"depth (the vertical distance below a particular reference e.g. sea level.)",
"timestamp (the timestamp of when a measurement value was recorded)",
"obukhov_length (a parameter with a dimension of length which, when used to scale the height above ground, gives a dimensionless stability parameter.)",
"other"
]
},
"orientation_reference": {
"type": [
"string",
"null"
],
"title": "Orientation Reference",
"description": "The orientation reference the item is measured against. E.g. magnetic north.",
"enum": [
"magnetic_north",
"true_north",
"grid_north",
null
]
},
"height_reference": {
"type": [
"string",
"null"
],
"title": "Height Reference",
"description": "The height reference frame that is used to measure the item height. E.g. onshore this is 'ground level' i.e. the item is 0.5 m above ground level. Offshore is a bit different as it can be 20 m above 'mean sea level' or 20 m above 'lowest astronomical tide' for a fixed structure or 20 m above 'sea level' for a floating lidar.",
"enum": [
"ground_level",
"mean_sea_level",
"sea_level",
"lowest_astronomical_tide",
"sea_floor",
"other",
null
],
"default": "ground_level"
}
},
"type": "object",
"title": "IEA Wind Resource Assessment - Data Model",
"description": "This Data Model schema is a digital representation of a meteorological mast used for measuring the wind resource of a potential wind farm.",
"properties": {
"author": {
"type": "string",
"title": "Author",
"description": "The person or system who created this data model representing a specific mast.",
"examples": [
"Stephen Holleran",
"Joe Bloggs"
]
},
"organisation": {
"type": "string",
"title": "Organisation",
"description": "The organisation the Author is from.",
"examples": [
"brightwind",
"Wind Developer Ltd."
]
},
"date": {
"type": "string",
"format": "date",
"title": "Date",
"description": "The date this file was created. Format should be YYYY-MM-DD",
"examples": [
"2020-07-28"
]
},
"version": {
"type": "string",
"title": "Version",
"description": "The version of the IEA WRA Data Model this file is based on. The format of this follows Semantic Versioning with the year and month tagged on after. E.g. 1.1.1-2020.07",
"examples": [
"0.1.0-2020.06",
"1.1.1-2020.07"
],
"pattern": "^([0-9]{1,2})[.]([0-9]{1,2})[.]([0-9]{1,2})-([0-9]{4})[.]([0-9]{2})$"
},
"license": {
"type": "string",
"title": "License",
"description": "Expected to be used as the Dublin Core Metadata Initiative intended. Link: http://purl.org/dc/terms/license Definition: A legal document giving official permission to do something with the resource. Comment: Recommended practice is to identify the license document with a URI. If this is not possible or feasible, a literal value that identifies the license may be provided.",
"examples": [
"https://opensource.org/license/bsd-3-clause/",
"BSD-3-Clause"
]
},
"plant_name": {
"type": [
"string",
"null"
],
"title": "Plant Name",
"description": "The name of the wind farm this met mast is associated with.",
"examples": [
"A Name of Wind Farm"
]
},
"plant_type": {
"type": [
"string",
"null"
],
"title": "Plant Type",
"description": "The type of renewable generation plant it is.",
"enum": [
"onshore_wind",
"offshore_wind",
"solar",
null
]
},
"measurement_location": {
"type": "array",
"title": "Measurement Location",
"description": "This is the geographic location of the meteorological measurement station i.e. a met mast/tower or remote sensing device.",
"items": {
"type": "object",
"title": "Measurement Location",
"properties": {
"uuid": {
"type": [
"string",
"null"
],
"format": "uuid",
"title": "UUID",
"description": "The unique identifier of the measurement location in the UUID format. A UUID can be generated here https://www.uuidgenerator.net/",
"examples": [
"3d40f012-a525-4024-a626-5fcf954c59cf"
]
},
"name": {
"type": "string",
"title": "Name",
"description": "The name given to the measurement location i.e. to the met mast or remote sensing device. Unique names are recommended to avoid two locations in the same context being given the same name.",
"examples": [
"AName_MM1"
]
},
"latitude_ddeg": {
"type": "number",
"title": "Latitude [ddeg]",
"description": "Latitude coordinate in the Geographic Coordinate System using the WGS84 reference coordinate system, [EPSG:4326](https://epsg.io/4326). Unit of measure is in decimal degrees. Latitude lines are parallel to the equator where their position ranges from -90 degrees at the south pole to 90 degrees at the north pole.",
"examples": [
52.973
],
"minimum": -90,
"maximum": 90
},
"longitude_ddeg": {
"type": "number",
"title": "Longitude [ddeg]",
"description": "Longitude coordinate in the Geographic Coordinate System using the WGS84 reference coordinate system, [EPSG:4326](https://epsg.io/4326). Unit of measure is in decimal degrees. Longitude lines are perpendicular to the equator where their position ranges from 0° at Greenwich Mean Time increasing to +180° as you move eastward and decreasing to −180° as you move westward.",
"examples": [
-9.431
],
"minimum": -180,
"maximum": 180
},
"measurement_station_type_id": {
"title": "Measurement Station Type",
"description": "The type of measurement station. This must be one of either met mast, lidar (a vertical profiler), sodar (also a vertical profiler), floating lidar (floating vertical profiler lidar), wave buoy, ADCP (Acoustic Doppler Current Profiler) or a solar measurement station.",
"type": "string",
"enum": [
"mast",
"lidar",
"sodar",
"floating_lidar",
"wave_buoy",
"adcp",
"solar",
"virtual_met_mast",
"reanalysis"
]
},
"notes": {
"$ref": "#/definitions/notes"
},
"update_at": {
"$ref": "#/definitions/update_at"
},
"mast_properties": {
"type": [
"object",
"null"
],
"title": "Mast Properties",
"description": "The properties of the installed met mast/tower. Additional properties can be added e.g. 'material' however this wouldn't be part of the Data Model. If an additional property is for information purposes please consider using 'notes' instead.",
"properties": {
"mast_geometry_id": {
"type": [
"string",
"null"
],
"title": "Mast Geometry",
"description": "The type of mast geometry e.g. lattice with a triangular profile or pole. The IEC specifies two square lattice towers as having rounded edges for their members or sharp edges.",
"enum": [
"lattice_triangle",
"lattice_square_round_edges",
"lattice_square_sharp_edges",
"pole",
null
]
},
"mast_oem": {
"type": [
"string",
"null"
],
"title": "Mast OEM",
"description": "The manufacturer of the met mast.",
"examples": [
"NRG Systems",
"Galetech Energy Services"
]
},
"mast_serial_number": {
"type": [
"string",
"null"
],
"title": "Mast Serial Number",
"description": "The manufacturer's serial number of the mast.",
"examples": [
"XHD12345",
"MM01234"
]
},
"mast_model": {
"type": [
"string",
"null"
],
"title": "Mast Model",
"description": "The model of the mast.",
"examples": [
"80m XHD TallTower",
"SLX80m"
]
},
"mast_height_m": {
"type": [
"number",
"null"
],
"title": "Mast Height [m]",
"description": "The height of the mast itself, not necessarily the top anemometer height.",
"examples": [
81.3
]
},
"date_from": {
"type": [
"string",
"null"
],
"format": "date-time",
"title": "Date From",
"description": "The date from when these properties are active. If these properties follow a change, then this Date From should equal the previous Date To. The format of this date should follow ISO 8601 with the 'T' required. If a timezone is used, it is essential that this timezone is the same as the logger timezone.",
"examples": [
"2020-07-28T20:00:00"
]
},
"date_to": {
"$ref": "#/definitions/date_to"
},
"notes": {
"$ref": "#/definitions/notes"
},
"update_at": {
"$ref": "#/definitions/update_at"
},
"mast_section_geometry": {
"type": [
"array",
"null"
],
"title": "Mast Section Geometry",
"description": "This contains the properties of each mast section. Additional properties can be added e.g. 'material' however this wouldn't be part of the Data Model. If an additional property is for information purposes please consider using 'notes' instead.",
"items": {
"type": "object",
"title": "Mast Section Geometry",
"properties": {
"uuid": {
"type": [
"string",
"null"
],
"format": "uuid",
"title": "UUID",
"description": "The unique id to relate this mast section to the mounting arrangement. A UUID can be generated here https://www.uuidgenerator.net/",
"examples": [
"bf078172-bbb6-48fe-ac1f-c6605dffb1b5"
]
},
"mast_section_height_mm": {
"type": [
"number",
"null"
],
"title": "Mast Section Height [mm]",
"description": "Towers come in sections that are connected together to make a complete met mast. This is the height in mm of this met mast section.",
"examples": [
6000
]
},
"pole_diameter_mm": {
"type": [
"number",
"null"
],
"title": "Pole Diameter [mm]",
"description": "If a pole mast is used, it's diameter in mm.",
"examples": [
203
]
},
"lattice_face_width_at_bottom_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Face Width at Bottom [mm]",
"description": "The lattice face width at the bottom of the mast section, as measured from leg centre to leg centre as outlined in [IEC 61400-12-1 2017 Fig G.5](https://user-images.githubusercontent.com/25622575/160807405-24f8ec74-e93f-4454-b41d-92ea30ffeb15.png).",
"examples": [
500
]
},
"lattice_face_width_at_top_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Face Width at Top [mm]",
"description": "The lattice face width at the top of the mast section, as measured from leg centre to leg centre as outlined in [IEC 61400-12-1 2017 Fig G.5](https://user-images.githubusercontent.com/25622575/160807405-24f8ec74-e93f-4454-b41d-92ea30ffeb15.png).",
"examples": [
500
]
},
"lattice_leg_width_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Leg Width [mm]",
"description": "The lattice leg diameter for a round leg or width for a square cross section leg.",
"examples": [
50
]
},
"lattice_leg_is_round_cross_section": {
"type": [
"boolean",
"null"
],
"title": "Lattice Leg is Round Cross Section",
"description": "The lattice leg is a round or square cross section. True is for a round leg cross section and false is for a square leg cross section.",
"examples": [
"true (for a round leg cross section)",
"false (for a square leg cross section)"
]
},
"lattice_bracing_member_diameter_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Bracing Member Diameter [mm]",
"description": "THIS FIELD WILL BE DEPRECIATED IN THE NEXT MAJOR RELEASE. The lattice diagonal bracing member diameter.",
"examples": [
12
]
},
"lattice_bracing_member_diameter_horizontal_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Bracing Member Diameter Horizontal [mm]",
"description": "The lattice horizontal bracing member diameter in mm.",
"examples": [
12
]
},
"lattice_bracing_member_diameter_diagonal_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Bracing Member Diameter Diagonal [mm]",
"description": "The lattice diagonal bracing member diameter in mm.",
"examples": [
12
]
},
"lattice_number_of_diagonal_bracing_members": {
"type": [
"integer",
"null"
],
"title": "Lattice Number of Bracing Members",
"description": "The number of lattice diagonal bracing members that are contained in one of the repetitive patterns making up a mast section.",
"examples": [
1,
2
]
},
"lattice_bracing_member_length_diagonal_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Bracing Member Length Diagonal [mm]",
"description": "The lattice diagonal bracing member length in mm.",
"examples": [
512
]
},
"number_of_repetitive_patterns_on_face": {
"type": [
"integer",
"null"
],
"title": "Number of Repetitive Patterns on Face",
"description": "The number of repetitive patterns on tower face as in the image. Note that for this case the pattern in red repeats itself 6 times. https://github.com/IEA-Task-43/digital_wra_data_standard/blob/master/images/number_of_repetitive_patterns_on_face.png.",
"examples": [
6
]
},
"lattice_bracing_member_height_mm": {
"type": [
"number",
"null"
],
"title": "Lattice Bracing Member Height [mm]",
"description": "The height of the lattice diagonal bracing members.",
"examples": [
900
]
},
"lattice_has_horizontal_member": {
"type": [
"boolean",
"null"
],
"title": "Does the tower have horizontal braces?",
"description": "This represents masts that have horizontal braces. True is for towers with horizontal braces and false is for towers without horizontal braces.",
"examples": [
"true (for towers with horizontal braces)",
"false (for towers without horizontal braces)"
]
},
"notes": {
"$ref": "#/definitions/notes"
},
"update_at": {
"$ref": "#/definitions/update_at"
}
},
"additionalProperties": true,
"required": [
]
},
"additionalItems": false,
"uniqueItems": true
}
},
"additionalProperties": true
},
"vertical_profiler_properties":{
"type": [
"array",
"null"
],
"title": "Vertical Profiler Properties",
"description": "Vertical profiler remote sensing devices (e.g. lidar, sodar and floating lidar) installation specific properties.",
"items": {
"type": "object",
"title": "Vertical Profiler Properties",
"properties": {
"device_datum_plane_height_m": {
"type": [
"number",
"null"
],
"title": "Device Datum Plane Height [m]",
"description": "The datum plane height of the remote sensing device where the datum feature is defined here: http://data.windenergy.dtu.dk/ontologies/view/ontolidar/en/page/DatumFeature . For lidars the datum feature is usually the window and for sodars it is usually the base of the device. These datum plane heights are also usually referred to as above ground level however it may be above sea level or above a platform level.",
"examples": [
0.5,
1
]
},
"height_reference_id": {
"$ref": "#/definitions/height_reference"
},
"device_orientation_deg": {
"type": [
"number",
"null"
],
"title": "Device Orientation [deg]",
"description": "The orientation that the remote sensing device is installed relative to north.",
"minimum": 0,
"maximum": 360
},
"orientation_reference_id": {
"$ref": "#/definitions/orientation_reference"
},
"device_vertical_orientation": {
"type": [
"string",
"null"
],
"title": "Device Vertical Orientation",
"description": "The vertical orientation that the remote sensing device is installed. E.g. an ADCP mounted on the sea floor has an 'upwards' vertical orientation pointing towards the sea surface whereas an ADCP mounted underneath a buoy has a 'downward' vertical orientation pointing towards the sea floor.",
"enum": [
"upward",
"downward",
null
]
},
"date_from": {
"type": [
"string",
"null"
],
"format": "date-time",
"title": "Date From",
"description": "The date from when these properties are active. If these properties follow a change, then this Date From should equal the previous Date To. The format of this date should follow ISO 8601 with the 'T' required. If a timezone is used, it is essential that this timezone is the same as the logger timezone.",
"examples": [
"2020-07-28T20:00:00"
]
},
"date_to": {
"$ref": "#/definitions/date_to"
},
"notes": {
"$ref": "#/definitions/notes"
},
"update_at": {
"$ref": "#/definitions/update_at"
}
},
"additionalProperties": false,
"required": [
]
},
"additionalItems": false,
"uniqueItems": true
},
"logger_main_config": {
"type": "array",
"title": "Logger Configuration",
"description": "This represents how the logger's main settings are configured. For example, it's sampling rate or averaging period. For remote sensing devices, such as lidar's, the device itself is considered as a logger and so these logger configuration attributes should be used to describe the lidar.",
"items": {
"type": "object",
"title": "Logger Configuration",
"properties": {
"logger_oem_id": {
"type": "string",
"title": "Logger OEM",
"description": "This is the logger or remote sensing device manufacturer id as defined by the IEA Wind Resource Assessment Data Model Schema.",
"enum": [
"NRG Systems",
"Ammonit",
"Campbell Scientific",
"Vaisala",
"SecondWind",
"Kintech",
"Wilmers",
"Unidata",
"WindLogger",
"Leosphere",
"ZX Lidars",
"AXYS Technologies",
"AQSystem",
"Pentaluum",
"Nortek",
"Teledyne RDI",
"Aanderaa",
"Other"
]
},
"logger_model_name": {
"type": [
"string",
"null"
],
"title": "Logger Model Name",
"description": "This is the logger or remote sensing device model name. This is usually stated in the data files from the logger in either the header or footer.",
"examples": [
"Symphonie Plus3",
"CR1000",
"Meteo-40M",
"WindCube v2"
]
},
"logger_serial_number": {
"type": "string",
"title": "Logger Serial Number",
"description": "The logger or remote sensing device serial number. This is sometimes different from the logger id."
},
"logger_firmware_version": {
"type": [
"string",
"null"
],
"title": "Logger Firmware Version",
"description": "The logger or remote sensing device's Firmware Version. This is the software version that is run on the logger at the time of data acquisition. This software can be updated and so can sometimes impact the results of the outputted data. E.g. NRG SymphoniePro, Firmware Version: 3.2.3. For loggers/devices that have multiple software programmes to process the outputted data the versions can be concatenated together."
},
"logger_id": {
"type": [
"string",
"null"
],
"title": "Logger Id",
"description": "This is the logger or remote sensing device id. It may be set by the logger programmer and may be different from the logger serial number.",
"examples": [
"4321",
"D123456",
"WLS7-999"
]
},
"logger_name": {
"type": [
"string",
"null"
],
"title": "Logger Name",
"description": "The logger (or mast name) name assigned to the logger in the logger programme.",
"examples": [
"AName_MM1"
]
},
"date_from": {
"$ref": "#/definitions/date_from"
},
"date_to": {
"$ref": "#/definitions/date_to"
},
"encryption_pin_or_key": {
"type": [
"string",
"null"
],
"title": "Encryption PIN or Key",
"description": "The encryption PIN or key used to encrypt the data.",
"examples": [
"9876",
"KkocDuSCk3v5tw4kRveHGQvuD1kYVVbU"
]
},
"enclosure_lock_details": {
"type": [
"string",
"null"
],
"title": "Enclosure Lock Details",
"description": "Details about how to open the logger enclosure box when on site.",
"examples": [
"Combination lock PIN 54321.",
"Physical key has id 54321."
]
},
"data_transfer_details": {
"type": [
"string",
"null"
],
"title": "Data Transfer Details",
"description": "Details about how the data is transferred from the logger to the recipient.",
"examples": [
"Logger emails to [email protected]",
"Retrieve data via LoggerNet."
]
},
"offset_from_utc_hrs": {
"$ref": "#/definitions/offset_from_utc_hrs"
},
"sampling_rate_sec": {
"type": [
"integer",
"null"
],
"title": "Sampling Rate [s]",
"description": "The number of seconds the logger samples data.",
"examples": [
"1",
"2"
]
},
"averaging_period_minutes": {
"$ref": "#/definitions/averaging_period_minutes"
},
"timestamp_is_end_of_period": {
"$ref": "#/definitions/timestamp_is_end_of_period"
},
"clock_is_auto_synced": {
"type": [
"boolean",
"null"
],
"title": "Clock is Auto-Synced",
"description": "Is the logger clock auto-synced with an internet time server to keep accurate time. True is for when the logger clock is auto-synced and false is for when the logger clock is not auto-synced.",
"examples": [
"true (for when the logger clock is auto-synced)",
"false (for when the logger clock is not auto-synced)"
]
},
"logger_acquisition_uncertainty": {
"type": [
"number",
"null"
],
"title": "Logger Acquisition Uncertainty [%]",
"description": "The uncertainty of the logger acquisition system as a percentage. This is also referred to as the uncertainty of the data acquisition system within IEC 61400-12-1. ",
"examples": [
"0.1"
]
},
"uncertainty_k_factor": {
"type": [
"number",
"null"
],
"title": "Uncertainty K Factor",
"description": "Uncertainty k factor for Logger Acquisition Uncertainty as provided in logger documentation specification.",
"examples": [
"2"
]
},
"notes": {
"$ref": "#/definitions/notes"
},
"update_at": {
"$ref": "#/definitions/update_at"
},
"lidar_config": {
"type": [
"array",
"null"
],
"title": "Lidar Specific Configuration",
"description": "The lidar specific configuration represents how the lidar's specific settings are configured. For example, if FCR is turned on.",
"items": {
"type": "object",
"title": "Lidar Specific Configuration",
"properties": {
"flow_corrections_applied": {
"type": [
"boolean",
"null"
],
"title": "Flow Corrections Applied",
"description": "Is there any flow corrections applied to the measured data by the lidar unit, e.g. Flow Complexity Recognition (FCR) for WindCubes?",
"examples": [
"true (for any flow corrections applied)",
"false (for no flow corrections applied)"
]
},
"date_from": {
"type": [
"string",
"null"
],
"format": "date-time",